IGameInput::EnableOemDeviceSupport
참고 항목
이 기능은 아직 구현되지 않았습니다.
GameInput API가 해당 입력 스트림에 노출하기를 원하는 플러그 앤 플레이 장치를 호출자가 지정합니다.
구문
HRESULT EnableOemDeviceSupport(
uint16_t vendorId,
uint16_t productId,
uint8_t interfaceNumber,
uint8_t collectionNumber
)
매개 변수
vendorId _In_
형식: uint16_t
OEM 장치를 식별하는 데 사용되는 공급업체 ID(VID).
productId _In_
형식: uint16_t
OEM 장치를 식별하는 데 사용되는 제품 ID(PID).
interfaceNumber _In_
형식: uint8_t
USB 인터페이스 번호(해당되는 경우).
collectionNumber _In_
형식: uint8_t
HID 컬렉션 번호(해당되는 경우 HIDCLASS.sys에 의해 할당됨).
반환 값
형식: HRESULT
E_NOTIMPL을(를) 반환합니다.
설명
이 방법으로 장치를 활성화하면 장치에 대한 원시 액세스(예: IOCTL(input/output 컨트롤))를 사용할 수 있습니다. OEM은 이러한 장치에서 원시 입력 보고서를 사용하고 자체 API 표면을 통해 기본 데이터를 공개합니다.
장치는 해당 VID/PID, USB 인터페이스 번호(해당되는 경우) 및 HID 컬렉션 번호(HIDCLASS.sys에 의해 할당)의 조합으로 식별됩니다. 이는 안정적인 식별 방법으로서, OEM 장치의 펌웨어가 (자신이 제어하는) 시스템에 자신을 알리는 방법과 연관됩니다.
EnableOemDeviceSupport 메서드를 통해 노출된 장치는 이를 요청한 장치에서만 볼 수 있습니다. OEM 장치를 위한 지원은 IGameInput 인터페이스(및 다른 모든 GameInput 인터페이스)에 대한 모든 참조가 해당 프로세스에 의해 해제될 때까지 지정한 프로세스에서 활성으로 유지됩니다.
한 응용 프로그램이 최대 1024개의 다른 OEM 장치에 대한 지원을 활성화할 수 있습니다. 이 제한을 초과하면 실패 HRESULT이(가) 반환됩니다. 이 메서드는 신속하게 반환되며, 시간에 민감한 컨텍스트에서 호출해도 안전합니다.
요건
헤더: GameInput.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔