iAudioOutputSelector::SetSelection 方法 (devicetopology.h)
SetSelection方法會選取輸出選取器的其中一個輸出。
語法
HRESULT SetSelection(
[in] UINT nIdSelect,
[in] LPCGUID pguidEventContext
);
參數
[in] nIdSelect
新的選取器輸出。 呼叫端應該將此參數設定為具有其中一個選取器輸出之直接連結之元件的本機識別碼。
[in] pguidEventContext
IControlChangeNotify::OnNotify方法的內容值。 此參數指向事件內容 GUID。 如果 SetSelection 呼叫變更輸出選取器控制項的狀態,則所有已註冊 IControlChangeNotify 介面的用戶端都會收到通知。 在 OnNotify 方法的實作中,用戶端可以檢查事件內容 GUID,以探索事件內容 GUID 或另一個用戶端是否為控制項變更事件的來源。 如果呼叫端提供此參數的 Null 指標,則用戶端的通知方法會收到 Null 內容指標。
傳回值
如果方法成功,它會傳回 S_OK。 如果失敗,可能的傳回碼包括但不限於下表所示的值。
傳回碼 | 描述 |
---|---|
|
參數 nIdSelect 不是選取器輸出中元件的本機識別碼。 |
|
記憶體不足。 |
備註
本機識別碼是一個數位,可唯一識別裝置拓撲中所有元件之間的部分。 若要取得元件的本機識別碼,請在元件物件上呼叫 IPart::GetLocalId 方法。
需求
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | devicetopology.h |