IKsJackDescription::GetJackCount-Methode (devicetopology.h)

Die GetJackCount-Methode ruft die Anzahl der Buchsen ab, die zum Herstellen einer Verbindung mit einem Audioendpunktgerät erforderlich sind.

Syntax

HRESULT GetJackCount(
  [out] UINT *pcJacks
);

Parameter

[out] pcJacks

Zeiger auf eine UINT-Variable , in die die Methode die Anzahl der Buchsen schreibt, die dem Connector zugeordnet sind.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, umfassen mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte, sind jedoch nicht darauf beschränkt.

Rückgabecode	Beschreibung
E_POINTER	Zeiger pcJacks ist NULL.

Hinweise

Ein Audioendpunktgerät, das einen Stream mit mehreren Kanälen wiedergibt oder aufzeichnet, erfordert möglicherweise eine Verbindung mit mehr als einer Buchse (physischer Connector).

Für eine Reihe von Surround-Lautsprechern, die einen 6-Kanal-Audiostream wiedergeben, kann beispielsweise drei Stereobuchsen erforderlich sein. In diesem Beispiel überträgt die erste Buchse die Kanäle für die Lautsprecher vorne links und vorne rechts, die zweite Buchse überträgt die Kanäle für die Lautsprecher front-center und low-frequency-effects (Subwoofer), und die dritte Buchse überträgt die Kanäle für die Lautsprecher seitlich links und rechts seitlich.

Nachdem Sie diese Methode zum Abrufen der Jack-Anzahl aufgerufen haben, rufen Sie die IKsJackDescription::GetJackDescription-Methode einmal für jede Buchse auf, um eine Beschreibung der Buchse zu erhalten.

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

IKsJackDescription-Schnittstelle

IKsJackDescription::GetJackDescription