次の方法で共有

IGameInput::StopCallback

  • [アーティクル]

コールバック関数のトリガーを停止します。

構文

void StopCallback(  
         GameInputCallbackToken callbackToken  
)

パラメーター

callbackToken _In_
型: GameInputCallbackToken

登録解除するコールバック関数のトークン。 関数が IGameInput::RegisterDeviceCallback で最初に登録されたときに生成されます。

戻り値

型: void

戻り値はありません。

解説

この関数は、コールバック関数からリソースを安全に削除できないという点で関数とは異なりますが、コールバック関数から呼び出すことはできます。

StopCallback メソッドと IGameInput::UnregisterCallback メソッドは若干異なります。 いずれかのメソッドを呼び出すことにより、関連付けられたコールバックが再びディスパッチされなくなります。 ただし、IGameInput::UnregisterCallback 関数が正常に戻るまで、コールバックに関連付けられているすべてのリソースは安全に解放されません (たとえば、コールバック関数をホストする DLL のアンロード)。 そのため、登録されたコールバック関数内からコールバックを登録解除することはできず、これを行おうとするとエラーが返されます。 ただし、コールバック関数内からのコールバックの取り消しは安全です。

要件

ヘッダー: GameInput.h

ライブラリ: xgameruntime.lib

サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体

関連項目

入力 API の概要
IGameInput
IGameInput::RegisterDeviceCallback
IGameInput::RegisterReadingCallback
IGameInput::RegisterSystemButtonCallback