Metodo IControlInterface::GetIID (devicetopology.h)
Il metodo GetIID ottiene l'ID interfaccia dell'interfaccia di controllo specifica della funzione della parte.
Sintassi
HRESULT GetIID(
[out] GUID *pIID
);
Parametri
[out] pIID
Puntatore a una variabile GUID in cui il metodo scrive l'ID interfaccia dell'interfaccia di controllo specifica della funzione della parte. Per altre informazioni, vedere la sezione Osservazioni.
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 |
|---|---|
|
Il puntatore pIID è NULL. |
Commenti
Un oggetto che rappresenta una parte (connettore o subunit) dispone di due interfacce di controllo. La prima è un'interfaccia di controllo generica, IControlInterface, che include metodi comuni a tutti i tipi di controlli. Il secondo è un'interfaccia di controllo specifica della funzione che include metodi che si applicano a un particolare tipo di controllo. Il metodo GetIID ottiene l'ID interfaccia della seconda interfaccia di controllo. Il client può fornire questo ID interfaccia al metodo IPart::Activate per creare un'istanza dell'interfaccia specifica della parte.
Il metodo ottiene uno degli ID dell'interfaccia specifici della funzione illustrati nella tabella seguente.
| ID interfaccia | Nome interfaccia |
|---|---|
| IID_IAudioAutoGainControl | IAudioAutoGainControl |
| IID_IAudioBass | IAudioBass |
| IID_IAudioChannelConfig | IAudioChannelConfig |
| IID_IAudioInputSelector | IAudioInputSelector |
| IID_IAudioLoudness | IAudioLoudness |
| IID_IAudioMidrange | IAudioMidrange |
| IID_IAudioMute | IAudioMute |
| IID_IAudioOutputSelector | IAudioOutputSelector |
| IID_IAudioPeakMeter | IAudioPeakMeter |
| IID_IAudioTreble | IAudioTreble |
| IID_IAudioVolumeLevel | IAudioVolumeLevel |
| IID_IDeviceSpecificProperty | IDeviceSpecificProperty |
| IID_IKsFormatSupport | IKsFormatSupport |
| IID_IKsJackDescription | IKsJackDescription |
Per ottenere l'ID interfaccia di un'interfaccia, usare l'operatore __uuidof . Ad esempio, l'ID interfaccia dell'interfaccia dell'interfaccia IAudioAutoGainControl è definita come segue:
const IID IID_IAudioAutoGainControl __uuidof(IAudioAutoGainControl)
Per altre informazioni sull'operatore __uuidof, vedere la documentazione Windows SDK.
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 |