Metodo IAudioInputSelector::SetSelection (devicetopology.h)
Il metodo SetSelection seleziona uno degli input del selettore di input.
Sintassi
HRESULT SetSelection(
[in] UINT nIdSelect,
[in] LPCGUID pguidEventContext
);
Parametri
[in] nIdSelect
Nuovo input del selettore. Il chiamante deve impostare questo parametro sull'ID locale di una parte con un collegamento diretto a uno degli input del selettore.
[in] pguidEventContext
Valore di contesto per il metodo IControlChangeNotify::OnNotify . Questo parametro punta a un GUID di contesto evento. Se la chiamata SetSelection modifica lo stato del controllo del selettore di input, tutti i client che hanno registrato interfacce IControlChangeNotify con tale controllo ricevono notifiche. Nell'implementazione del metodo OnNotify , un client può esaminare il GUID del contesto evento per individuare se è l'origine dell'evento control-change o di un altro client. Se il chiamante fornisce un puntatore NULL per questo parametro, il metodo di notifica del client riceve un puntatore di contesto NULL .
Valore restituito
Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i codici restituiti possibili includono, ma non sono limitati a, i valori visualizzati nella tabella seguente.
| Codice restituito | Descrizione |
|---|---|
|
Parametro nIdSelect non è l'ID locale di una parte in un input del selettore. |
|
Memoria insufficiente. |
Commenti
Un ID locale è un numero che identifica in modo univoco una parte tra tutte le parti in una topologia del dispositivo. Per ottenere l'ID locale di una parte, chiamare il metodo IPart::GetLocalId nell'oggetto part.
Per un esempio di codice che chiama il metodo SetSelection , vedere l'implementazione della funzione SelectCaptureDevice in Topologie dispositivo.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | devicetopology.h |