Metodo IControlInterface::GetIID (devicetopology.h)

  • Articolo

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
E_POINTER
 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

Vedi anche

Interfaccia IControlInterface