Skip to main content

XUserGetDefaultAudioEndpointUtf16

擷取特定使用者的預設音訊端點。

語法

參數

user   
類型:XUserLocalId
要取得其預設音訊端點之使用者的本機識別碼。
defaultAudioEndpointKind   
類型:XUserDefaultAudioEndpointKind
列舉值,指定使用者的預設音訊端點是轉譯還是擷取音訊。
endpointIdUtf16Count   
類型:size_t
endpointIdUtf16 參數所指向之緩衝區的 wchar_t 計數。請傳遞 XUserAudioEndpointMaxUtf16Count。
endpointIdUtf16   _Out_writes_to_(endpointIdUtf16Count,endpointIdUtf16Used)
類型:wchar_t

包含使用者預設音訊端點的識別碼。
endpointIdUtf16Used   _Out_opt_
類型:size_t*
包含 endpointIdUtf16 參數所傳回之識別碼的實際 wchar_t 計數。

傳回值

類型:HRESULT 如果成功,則傳回 S_OK;否則傳回錯誤碼。 如需錯誤碼清單,請參閱錯誤碼。

備註

在時間敏感執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感執行緒。
XUserGetDefaultAudioEndpointUtf16 函式會接受 XUserDefaultAudioEndpointKind 列舉作為引數。 當特定使用者的預設音訊端點變更時,會叫用 XUserDefaultAudioEndpointUtf16ChangedCallback 回呼函式。 若要註冊以在預設音訊端點變更時接收回呼,請呼叫 XUserRegisterForDefaultAudioEndpointUtf16Changed。 若要取消註冊在預設音訊端點變更時接收回呼,請呼叫 XUserUnregisterForDefaultAudioEndpointUtf16Changed。 下列範例示範如何擷取使用者的預設音訊端點。

需求

標頭: XUser.h 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

XUser XUserDefaultAudioEndpointUtf16ChangedCallback XUserRegisterForDefaultAudioEndpointUtf16Changed XUserUnregisterForDefaultAudioEndpointUtf16Changed
Last modified on October 6, 2026