Microsoft DirectX 8.0 (C++)

IDirectInputDevice8::Poll

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 で宣言。

参照

ポーリングとイベント通知