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 |
|---|---|
|
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 |