IAudioInputSelector::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。 如果失敗,可能的傳回碼包括但不限於下表所示的值。
傳回碼 | Description |
---|---|
|
參數 nIdSelect 不是選取器輸入中元件的本機標識碼。 |
|
記憶體不足。 |
備註
本機標識碼是一個數位,可唯一識別裝置拓撲中所有元件之間的部分。 若要取得元件的本機標識碼,請在元件物件上呼叫 IPart::GetLocalId 方法。
如需呼叫 SetSelection 方法的程式代碼範例,請參閱裝置拓撲中的 SelectCaptureDevice 函式 實作。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | devicetopology.h |