Condividi tramite


Metodo IPart::GetControlInterface (devicetopology.h)

Il metodo GetControlInterface ottiene un riferimento all'interfaccia di controllo specificata, se supportata da questa parte.

Sintassi

HRESULT GetControlInterface(
  [in]  UINT              nIndex,
  [out] IControlInterface **ppInterfaceDesc
);

Parametri

[in] nIndex

Numero di interfaccia del controllo. Se una parte supporta n interfacce di controllo, le interfacce di controllo vengono numerate da 0 a n- 1.

[out] ppInterfaceDesc

Puntatore a una variabile puntatore in cui il metodo scrive l'indirizzo dell'interfaccia IControlInterface della funzione audio specificata. Tramite questo metodo, il chiamante ottiene un riferimento conteggiato all'interfaccia. Il chiamante è responsabile del rilascio dell'interfaccia, quando non è più necessario, chiamando il metodo Release dell'interfaccia. Se la chiamata GetControlInterface ha esito negativo, *ppFunction è NULL.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i possibili codici restituiti includono, ma non sono limitati, i valori illustrati nella tabella seguente.

Codice restituito Descrizione
E_POINTER
Il puntatore ppFunction è NULL.
E_INVALIDARG
Il parametro nIndex non è compreso nell'intervallo.
E_NOTFOUND
La parte non dispone di un'interfaccia di controllo.

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 IControlInterface

Interfaccia IPart