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 |
|---|---|
|
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.
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 | OptionalOptional Optional |
| KSNODETYPE_VOLUME | IAudioChannelConfig | 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 |