IPart::GetSubType-Methode (devicetopology.h)

Die GetSubType-Methode ruft den Teiluntertyp dieses Teils ab.

Syntax

HRESULT GetSubType(
  [out] GUID *pSubType
);

Parameter

[out] pSubType

Zeiger auf eine GUID-Variable, in die die Methode den Untertyp GUID für diesen Teil schreibt.

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	Der Zeiger pSubType ist NULL.

Hinweise

Diese Methode ruft in der Regel einen der KSNODETYPE_Xxx GUID-Werte aus der Headerdatei Ksmedia.h ab, obwohl einige benutzerdefinierte Treiber möglicherweise andere GUID-Werte bereitstellen. Weitere Informationen zu KSNODETYPE_Xxx-GUIDs finden Sie in der Windows DDK-Dokumentation.

Wie in IPart-Schnittstelle erläutert, kann ein Teil entweder ein Connector oder eine Untereinheit sein.

Für einen Teil, der ein Connector ist, ruft diese Methode die PIN-Kategorie-GUID ab, die der Treiber dem Connector zugewiesen hat. Im Folgenden sind Beispiele für PIN-Kategorie-GUIDs aufgeführt:

• KSNODETYPE_ANALOG_CONNECTOR, wenn der Connector Teil des Datenpfads zu oder von einem analogen Gerät wie einem Mikrofon oder Lautsprechern ist.
• KSNODETYPE_SPDIF_INTERFACE, wenn der Connector Teil des Datenpfads zu oder von einem S/PDIF-Port ist.

Weitere Informationen finden Sie in der Erläuterung der Pin-Category-Eigenschaft KSPROPERTY_PIN_CATEGORY in der Windows DDK-Dokumentation.

Für einen Teil, der eine Untereinheit ist, ruft diese Methode eine Untertyp-GUID ab, die die Streamverarbeitungsfunktion angibt, die die Untereinheit ausführt. Für eine Volumesteuerungsuntereinheit ruft die Methode beispielsweise den GUID-Wert KSNODETYPE_VOLUME ab.

In der folgenden Tabelle sind einige der Untertyp-GUIDs aufgeführt, die von der GetSubType-Methode für eine Untereinheit abgerufen werden können.

Untertyp-GUID	Steuerungsschnittstelle	Erforderlich oder optional
KSNODETYPE_3D_EFFECTS	IAudioChannelConfig	Optional
KSNODETYPE_AGC	IAudioAutoGainControl	Erforderlich
KSNODETYPE_DAC	IAudioChannelConfig	Optional
KSNODETYPE_DEMUX	IAudioOutputSelector	Erforderlich
KSNODETYPE_DEV_SPECIFIC	IDeviceSpecificProperty	Erforderlich
KSNODETYPE_LOUDNESS	IAudioLoudness	Erforderlich
KSNODETYPE_MUTE	IAudioMute	Erforderlich
KSNODETYPE_MUX	IAudioInputSelector	Erforderlich
KSNODETYPE_PEAKMETER	IAudioPeakMeter	Erforderlich
KSNODETYPE_PROLOGIC_DECODER	IAudioChannelConfig	Optional
KSNODETYPE_TONE	IAudioBass IAudioMidrange IAudioTreble	OptionalOptional Optional
KSNODETYPE_VOLUME	IAudioChannelConfig IAudioVolumeLevel	OptionalRequired

 

In der obigen Tabelle listet die mittlere Spalte die Steuerelementschnittstellen auf, die von Untereinheiten des in der linken Spalte angegebenen Untertyps unterstützt werden. Die rechte Spalte gibt an, ob die Unterstützung der Untereinheit für eine Steuerungsschnittstelle erforderlich oder optional ist. Wenn Unterstützung erforderlich ist, kann sich eine Anwendung auf eine Untereinheit des angegebenen Untertyps verlassen, um die Steuerungsschnittstelle zu unterstützen. Wenn die Unterstützung optional ist, kann eine Untereinheit des angegebenen Untertyps die Steuerungsschnittstelle unterstützen, aber nicht notwendigerweise.

Die Steuerungsschnittstellen in der vorherigen Tabelle ermöglichen einen bequemen Zugriff auf die Eigenschaften von Untereinheiten. Einige Untereinheiten verfügen jedoch über Eigenschaften, für die keine entsprechenden Steuerelementschnittstellen vorhanden sind. Anwendungen können über die IKsControl-Schnittstelle auf diese Eigenschaften zugreifen. Weitere Informationen finden Sie unter Verwenden der IKsControl-Schnittstelle für den Zugriff auf Audioeigenschaften.

Anforderungen

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

IPart-Schnittstelle