IDirectInputDevice8::Poll メソッド
IDirectInputDevice8::Poll メソッド
Microsoft® DirectInput® デバイス上のポーリング対象オブジェクトからデータを取得する。デバイスにポーリングが必要ないときに、このメソッドを呼び出しても効果はない。ポーリングする必要があるデバイスが定期的にポーリングされない場合、このデバイスから新しいデータは取得されない。このメソッドを呼び出すと、DirectInput はデバイス状態を更新し、バッファリング データが使用可能な場合は入力イベントを生成し、通知が有効な場合は通知イベントを設定する。
構文
HRESULT Poll(VOID);
戻り値
成功した場合は、DI_OK を返す。デバイスがポーリングを要求しない場合は、DI_NOEFFECT を返す。
失敗した場合は、次のいずれかのエラー値を返す。
| DIERR_INPUTLOST | 入力デバイスへのアクセスが失われた。再取得しなければならない。 |
| DIERR_NOTACQUIRED | 操作は、デバイスが取得されない限り実行できない。 |
| DIERR_NOTINITIALIZED | このオブジェクトは初期化されていない。 |
注意
デバイス データをポーリングする前に、IDirectInputDevice8::SetDataFormat または IDirectInputDevice8::SetActionMap メソッドでデータ形式を設定し、IDirectInputDevice8::Acquire メソッドでデバイスを取得しておかなければならない。
参照