IDirectInputDevice8::SendDeviceData 메서드

출력을 받아들이는 장치에 데이터를 송신한다.

주 IDirectInputDevice8::SendDeviceData 로부터의 출력을 받아들이는 장치는 없다. 「주의」를 참조할것.

구문

HRESULT SendDeviceData(      

    DWORD cbObjectData,
    LPCDIDEVICEOBJECTDATA rgdod,
    LPDWORD pdwInOut,
    DWORD fl
);

파라미터

cbObjectData
단일의 DIDEVICEOBJECTDATA 구조체의 사이즈 (바이트 단위).
rgdod
장치에 송신하는 데이터를 저장 한 DIDEVICEOBJECTDATA 구조체의 배열.
pdwInOut
호출시는, 이 파라미터가 가리키는 변수에는,rgdod 가 가리키는 배열의 요소수가 포함된다. 종료시는, 장치에 송신된 요소수가 포함된다.
fl
데이터의 송신 방법을 제어하는 플래그. 제로 또는 다음의 값을 지정할 수 있다.
DISDD_CONTINUE
송신되는 장치 데이터는, 이전에 송신된 장치 데이터에 덧쓰기된다.

반환값

성공했을 경우는, DI_OK 를 돌려준다.
실패했을 경우는, 다음의 몇개의 에러값을 돌려준다.
DIERR_INPUTLOST 입력 장치에의 액세스가 없어졌다. 재취득해야 한다.
DIERR_NOTACQUIRED 조작은, 장치가 취득되지 않는 한 실행할 수 없다.
DIERR_REPORTFULL 보내지는 정보가, 장치에 보낼 수가 있는 정보보다 많다.
DIERR_UNPLUGGED 이 조작은, 장치가 접속되지 않기 때문에 완료할 수 없었다.

주의

애플리케이션은,IDirectInputDevice8::SendDeviceData 를 사용해서는 안 된다. force feedback가, 장치에 데이터를 송신하기 위한 추천의 방법이다. LED 나 내부 장치 상태의 변경 등, 그 외의 데이터를 장치에 송신하는 경우는,HID 애플리케이션 프로그래밍 인터페이스 (API)가 추천의 방법이다.

DIERR_INPUTLOST	입력 장치에의 액세스가 없어졌다. 재취득해야 한다.
DIERR_NOTACQUIRED	조작은, 장치가 취득되지 않는 한 실행할 수 없다.
DIERR_REPORTFULL	보내지는 정보가, 장치에 보낼 수가 있는 정보보다 많다.
DIERR_UNPLUGGED	이 조작은, 장치가 접속되지 않기 때문에 완료할 수 없었다.