IPinName::GetPinName-Methode (portcls.h)

Artikel
02/07/2025

Die GetPinName-Methode ruft den Anzeigenamen eines Audioendpunkts ab. Weitere Informationen zu Pins finden Sie unter Filter-, Pin- und Node-Eigenschaften.

Syntax

NTSTATUS GetPinName(
  [in]  PIRP     Irp,
  [in]  PKSP_PIN Pin,
  [out] PVOID    Data
);

Parameter

[in] Irp

Gibt einen Zeiger auf eine I/O-Anforderungspaketstruktur (IRP) an. Weitere Informationen zu IRPs finden Sie unter IRP- und E/A-Anforderungspakete.

[in] Pin

Gibt einen Zeiger auf den zugrunde liegenden Kernelstreaming -Pin (KS) an.

[out] Data

Gibt einen Zeiger auf den Puffer an, der die Daten für die GetPinName -Methode enthält.

Rückgabewert

Die GetPinName-Methode gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben.

Bemerkungen

Wenn ein Client den aktuellen Pinnamen eines Endpunkts benötigt, aber festgestellt hat, dass der Miniporttreiber die GetPinName-Methode nicht unterstützt, verwendet der Client den Anzeigenamen des Topologiebrücken-Pins. Weitere Informationen zu Pinkategorien und Anzeigenamen finden Sie unter Pin Category Property und Friendly Names for Audio Endpoint Devices.

Weitere Informationen zu

Hinweis In Windows 7 unterstützt der Audiostapel für den Benutzermodus keine Anpassung des Lautsprecherendpunktnamens. In Windows 7 funktioniert die GetPinName-Methode nur mit Endpunkten, die nicht über den Anzeigenamen "Lautsprecher" verfügen. In der folgenden Liste sind die KS-Knotentypkategorien aufgeführt, denen der Anzeigename "Lautsprecher" zugewiesen ist:

KSNODETYPE_SPEAKER

KSNODETYPE_DESKTOP_SPEAKER

KSNODETYPE_ROOM_SPEAKER

KSNODETYPE_LOW_FREQUENCY_EFFECTS_SPEAKER

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows 7 und höheren Versionen von Windows.
Zielplattform-	Universal
Header-	portcls.h (include Portcls.h)
IRQL-	PASSIVE_LEVEL.