次の方法で共有


IXtfConfigSettingsCallback::OnFoundSetting

構成設定がレポートされているときに呼び出されるコールバック関数。

構文

HRESULT OnFoundSetting(
         const PXTFCONFIGSETTING pSetting
)  

パラメーター

pSetting
型: PXTFCONFIGSETTING

構成設定を記述する XTFCONFIGSETTING 構造体へのポインター。

戻り値

型: HRESULT

正常に実行された場合は S_OK を返し、失敗した場合は HRESULT エラー コードを返します。

解説

このコールバック関数は、開発機本体にある各構成設定の IXtfConsoleControlClient::GetConfigSettings によって呼び出されます。 この関数は、構成設定の名前と値が格納されている XTFCONFIGSETTING 構造体へのポインターを受け取ります。 Xbox Tools Framework (XTF) を使用して構成設定にアクセスする方法については、「構成 (xbconfig.exe) (NDA トピック)認可が必須です」を参照してください。

注意

XTFCONFIGSETTING 構造体用のメモリは Xbox Tools Framework (XTF) API によって所有され、このコールバック関数の毎回の呼び出し後に無効化されます。 後で使用するために構造体内の情報が必要な場合は、情報をコピーしておく必要があります。

要件

ヘッダー: xtfconsolecontrol.h

ライブラリ: xtfconsolecontrol.lib

サポートされているプラットフォーム: Windows (Xbox 本体ツール用)

関連項目

IXtfConfigSettingsCallback
XtfConsoleControl
Xbox Tools Framework ネイティブ API リファレンス