IControlInterface::GetIID-Methode (devicetopology.h)
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 |
|---|---|
|
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 |