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 |
|---|---|
|
Il puntatore ppFunction è NULL. |
|
Il parametro nIndex non è compreso nell'intervallo. |
|
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 |