Skip to main content

XUserGetDefaultAudioEndpointUtf16

特定のユーザーの既定のオーディオ エンドポイントを取得します。

構文

パラメーター

user   
Type: XUserLocalId
既定のオーディオ エンドポイントを取得する対象のユーザーのローカル ID です。
defaultAudioEndpointKind   
Type: XUserDefaultAudioEndpointKind
ユーザーの既定のオーディオ エンドポイントがオーディオをレンダリングするかキャプチャするかを指定する列挙値です。
endpointIdUtf16Count   
Type: size_t
endpointIdUtf16 パラメーターが指すバッファーの wchar_t 数です。XUserAudioEndpointMaxUtf16Count を渡します。
endpointIdUtf16   _Out_writes_to_(endpointIdUtf16Count,endpointIdUtf16Used)
Type: wchar_t

ユーザーの既定のオーディオ エンドポイントの ID が格納されます。
endpointIdUtf16Used   _Out_opt_
Type: size_t*
endpointIdUtf16 パラメーターが返す ID の実際の wchar_t 数が格納されます。

戻り値

Type: HRESULT 成功した場合は S_OK を返します。それ以外の場合はエラー コードを返します。 エラー コードの一覧については、エラー コード を参照してください。

解説

この関数は、時間依存スレッドから呼び出しても安全ではありません。詳細については、時間依存スレッド を参照してください。
XUserGetDefaultAudioEndpointUtf16 関数は、引数として XUserDefaultAudioEndpointKind 列挙値を受け取ります。 XUserDefaultAudioEndpointUtf16ChangedCallback コールバック関数は、特定ユーザーの既定のオーディオ エンドポイントが変更されたときに呼び出されます。 既定のオーディオ エンドポイントが変更されたときにコールバックを受け取るように登録するには、XUserRegisterForDefaultAudioEndpointUtf16Changed を呼び出します。 既定のオーディオ エンドポイントが変更されたときのコールバック登録を解除するには、XUserUnregisterForDefaultAudioEndpointUtf16Changed を呼び出します。 以下の例は、ユーザーの既定のオーディオ エンドポイントを取得する方法を示しています。

要件

ヘッダー: XUser.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリ本体および XBOX Series 本体

概念ドキュメント

関連項目

XUser XUserDefaultAudioEndpointUtf16ChangedCallback XUserRegisterForDefaultAudioEndpointUtf16Changed XUserUnregisterForDefaultAudioEndpointUtf16Changed
最終更新日 2026年8月24日