Platform SDK: DirectX

IDirectInputDevice7::Poll

IDirectInputDevice7::Poll メソッドは、DirectInput デバイス上のポーリング対象オブジェクトからデータを取得する。デバイスにポーリングが必要ないときにこのメソッドを呼び出しても、エフェクトは一切ない。ポーリングする必要があるデバイスが定期的にポーリングされない場合、このデバイスから新しいデータは取得されない。このメソッドを呼び出すと、DirectInput はデバイス状態を更新し、バッファリング データが使用可能であれば入力イベントを生成し、通知が有効であれば通知イベントを設定する。

HRESULT Poll()

パラメータ

なし。

戻り値

成功すれば DI_OK を返す。デバイスがポーリングを要求しない場合は DI_NOEFFECT を返す。

失敗すれば次のエラー値のいずれかを返す。

DIERR_INPUTLOST
DIERR_NOTACQUIRED
DIERR_NOTINITIALIZED

注意

デバイス データをポーリングする前に、IDirectInputDevice7::SetDataFormat メソッドでデータ形式を設定して、IDirectInputDevice7::Acquire メソッドでデバイスを取得しなければならない。

動作環境

  Windows NT/2000 :Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dinput.h で宣言。
  インポート ライブラリ : dinput.lib を使用。

参照

ポーリングとイベント