IPart::GetSubType-Methode (devicetopology.h)
Die GetSubType--Methode ruft den Teiluntertyp dieses Teils ab.
Syntax
HRESULT GetSubType(
[out] GUID *pSubType
);
Parameter
[out] pSubType
Zeigen Sie auf eine GUID-Variable, in die die Methode die Untertyp-GUID für diesen Teil schreibt.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, enthalten mögliche Rückgabecodes, sind jedoch nicht beschränkt auf die in der folgenden Tabelle gezeigten Werte.
| Rückgabecode | Beschreibung |
|---|---|
|
Zeiger pSubType ist NULL-. |
Bemerkungen
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 Interfaceerläutert, kann ein Teil entweder ein Verbinder oder eine Untereinheit sein.
Bei einem Teil, der ein Verbinder ist, ruft diese Methode die PIN-Kategorie-GUID ab, die der Treiber dem Verbinder zugewiesen hat. Im Folgenden sind Beispiele für PIN-Kategorie-GUIDs aufgeführt:
- KSNODETYPE_ANALOG_CONNECTOR, wenn der Verbinder Teil des Datenpfads zu oder von einem analogen Gerät wie einem Mikrofon oder Lautsprecher ist.
- KSNODETYPE_SPDIF_INTERFACE, wenn der Verbinder Teil des Datenpfads zu oder von einem S/PDIF-Port ist.
Bei einem Teil, der eine Untereinheit ist, ruft diese Methode eine Untertyp-GUID ab, die die Streamverarbeitungsfunktion angibt, die von der Untereinheit ausgeführt wird. Bei einer 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 | Wahlfrei |
| KSNODETYPE_AGC | IAudioAutoGainControl- | Erforderlich |
| KSNODETYPE_DAC | IAudioChannelConfig | Wahlfrei |
| 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 | Wahlfrei |
| KSNODETYPE_TONE | IAudioBass- | OptionalOptional Wahlfrei |
| KSNODETYPE_VOLUME | IAudioChannelConfig | OptionalRequired |
In der vorherigen Tabelle werden in der mittleren Spalte die Steuerelementschnittstellen aufgelistet, 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 Steuerelementschnittstelle erforderlich oder optional ist. Wenn Unterstützung erforderlich ist, kann eine Anwendung auf eine Untereinheit des angegebenen Untertyps zurückgreifen, um die Steuerelementschnittstelle zu unterstützen. Wenn die Unterstützung optional ist, kann eine Untereinheit des angegebenen Untertyps die Steuerelementschnittstelle jedoch nicht unbedingt unterstützen.
Die Steuerelementschnittstellen 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 Using the IKsControl Interface to Access Audio Properties.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2008 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | devicetopology.h |