Condividi tramite


Metodo IAudioOutputSelector::SetSelection (devicetopology.h)

Il metodo SetSelection seleziona uno degli output del selettore di output.

Sintassi

HRESULT SetSelection(
  [in] UINT    nIdSelect,
  [in] LPCGUID pguidEventContext
);

Parametri

[in] nIdSelect

Nuovo output del selettore. Il chiamante deve impostare questo parametro sull'ID locale di una parte con un collegamento diretto a uno degli output 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 output, 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
E_INVALIDARG
Parametro nIdSelect non è l'ID locale di una parte in un output del selettore.
E_OUTOFMEMORY
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.

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione devicetopology.h

Vedi anche

Interfaccia IAudioOutputSelector

IPart::GetLocalId