Microsoft DirectX 8.0 (C++) |
Microsoft® DirectInput® デバイス上のポーリング対象オブジェクトからデータを取得する。デバイスにポーリングが必要ないときにこのメソッドを呼び出しても、効果は一切ない。ポーリングする必要があるデバイスが定期的にポーリングされない場合、このデバイスから新しいデータは取得されない。このメソッドを呼び出すと、DirectInput はデバイス状態を更新し、バッファリング データが使用可能であれば入力イベントを生成し、通知が有効であれば通知イベントを設定する。
HRESULT Poll()
なし。
成功した場合は、DI_OK を返す。デバイスがポーリングを要求しない場合は DI_NOEFFECT を返す。
失敗した場合は、次のいずれかのエラー値を返す。
DIERR_INPUTLOST |
DIERR_NOTACQUIRED |
DIERR_NOTINITIALIZED |
デバイス データをポーリングする前に、IDirectInputDevice8::SetDataFormat または IDirectInputDevice8::SetActionMap メソッドでデータ形式を設定し、IDirectInputDevice8::Acquire メソッドでデバイスを取得しておかなければならない。
Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
ヘッダー : dinput.h で宣言。