Share via

IControlInterface::GetIID-Methode (devicetopology.h)

  • Artikel

Die GetIID-Methode ruft die Schnittstellen-ID der funktionsspezifischen Steuerelementschnittstelle des Teils ab.

Syntax

HRESULT GetIID(
  [out] GUID *pIID
);

Parameter

[out] pIID

Zeiger auf eine GUID-Variable, in die die -Methode die Schnittstellen-ID der funktionsspezifischen Steuerelementschnittstelle des Teils schreibt. Weitere Informationen finden Sie in den Hinweisen.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.

Rückgabecode Beschreibung
E_POINTER
 Zeiger pIID ist NULL.

Hinweise

Ein Objekt, das einen Teil (Connector oder Untereinheit) darstellt, verfügt über zwei Steuerelementschnittstellen. Die erste ist eine generische Steuerelementschnittstelle, IControlInterface, die Über Methoden verfügt, die für alle Arten von Steuerelementen gemeinsam sind. Die zweite ist eine funktionsspezifische Steuerelementschnittstelle mit Methoden, die auf einen bestimmten Steuerelementtyp angewendet werden. Die GetIID-Methode ruft die Schnittstellen-ID der zweiten Steuerelementschnittstelle ab. Der Client kann diese Schnittstellen-ID für die IPart::Activate-Methode bereitstellen, um eine instance der funktionsspezifischen Schnittstelle des Teils zu erstellen.

Die -Methode ruft eine der funktionsspezifischen Schnittstellen-IDs ab, die in der folgenden Tabelle angezeigt werden.

Schnittstellen-ID Schnittstellenname
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
 

Verwenden Sie den Operator __uuidof , um die Schnittstellen-ID einer Schnittstelle abzurufen. Die Schnittstellen-ID der IAudioAutoGainControl-Schnittstelle ist beispielsweise wie folgt definiert:


const IID IID_IAudioAutoGainControl  __uuidof(IAudioAutoGainControl)

Weitere Informationen zum __uuidof-Operator finden Sie in der Windows SDK-Dokumentation.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile devicetopology.h

Weitere Informationen

IControlInterface-Schnittstelle