IConnector::GetType-Methode (devicetopology.h)

  • Artikel

Die GetType-Methode ruft den Typ dieses Connectors ab.

Syntax

HRESULT GetType(
  [out] ConnectorType *pType
);

Parameter

[out] pType

Zeiger auf eine Variable, in die die Methode den Connectortyp schreibt. Der Connectortyp ist eine der folgenden ConnectorType-Enumerationskonstanten :

Unknown_Connector

Physical_Internal

Physical_External

Software_IO

Software_Fixed

Netzwerk

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

Hinweise

Ein Connector entspricht einem "Pin" in der KS-Terminologie (Kernelstreaming). Die Zuordnung von KS-Pins zu Connectors ist wie folgt:

  • Wenn der Kommunikationstyp der KS-Pin KSPIN_COMMUNICATION_SINK, KSPIN_COMMUNICATION_SOURCE oder KSPIN_COMMUNICATION_BOTH ist, wird der Verbindungstyp Software_IO.
  • Andernfalls ist der Pin Teil einer physischen Verbindung zwischen zwei KS-Filtern (Geräten) im gleichen Audioadapter oder in verschiedenen Audioadaptern, dann ist der Connectortyp Software_Fixed.
  • Andernfalls wird der Steckertyp Physical_External, wenn die KS-Pinkategorie KSNODETYPE_SPEAKER, KSNODETYPE_MICROPHONE, KSNODETYPE_LINE_CONNECTOR oder KSNODETYPE_SPDIF_INTERFACE ist.
  • Andernfalls ist für einen Pin, der keines der vorherigen Kriterien erfüllt, der Connectortyp Physical_Internal.
Weitere Informationen zu KS-Pins finden Sie in der Windows DDK-Dokumentation.

Ein Codebeispiel, das die GetType-Methode aufruft, finden Sie in der Implementierung der SelectCaptureDevice-Funktion in Gerätetopologien.

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

Weitere Informationen

IConnector-Schnittstelle