注意
この関数はまだ実装されていません。
呼び出し元が入力ストリームで 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) などのデバイスに直接アクセスできるようになります。 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 本体