新しい読み取り値が入力ストリームに到着したときに呼び出される関数を登録します。
構文
HRESULT RegisterReadingCallback(
IGameInputDevice* device,
GameInputKind inputKind,
void* context,
GameInputReadingCallback callbackFunc,
GameInputCallbackToken* callbackToken
);
パラメーター
device _In_opt_
型: IGameInputDevice*
登録されたコールバックを特定のデバイスのトリガーのみに制限します。
inputKind _In_
型: GameInputKind
登録されたコールバックを、指定された入力の種類の 1 つ以上をサポートするデバイスのトリガーのみに制限します。
context _In_opt_
型: void*
コールバック関数に関連する情報を提供するいくつかのオブジェクト。 通常は、呼び出し元のオブジェクトです。
callbackFunc_In_
型: GameInputReadingCallback
タイトル定義コールバック関数。
callbackToken _Result_zeroonfailure_
型: GameInputCallbackToken*
登録されているコールバック関数を識別するトークン。 このトークンは、コールバック関数を取り消すか登録解除する場合に登録されている関数を識別するために使用されます。
戻り値
型: HRESULT
関数の結果です。
解説
コールバックを登録しても、指定された入力フィルターに一致する最新の読み取り値で初期コールバックがディスパッチされることはありません。 後続の状態変化についてコールバックがディスパッチされるだけです。
要件
ヘッダー: GameInput.h
入力 API の概要
IGameInput
IGameInput::UnregisterCallback
IGameInput::StopCallback