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