IPinName::GetPinName-Methode (portcls.h)

Artikel
02/26/2024

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

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.

Hinweise

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 Anheftkategorien und Anzeigenamen finden Sie unter Anheften von Kategorieeigenschaften und Anzeigenamen für Audioendpunktgeräte.

Weitere Informationen über

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

KSNODETYPE_SPEAKER

KSNODETYPE_DESKTOP_SPEAKER

KSNODETYPE_ROOM_SPEAKER

KSNODETYPE_LOW_FREQUENCY_EFFECTS_SPEAKER

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 7 und späteren Windows-Versionen.
Zielplattform	Universell
Header	portcls.h (include Portcls.h)
IRQL	PASSIVE_LEVEL.