IPinName ::GetPinName, méthode (portcls.h)

Article
02/29/2024

La GetPinName méthode récupère le nom convivial d’un point de terminaison audio. Pour plus d’informations sur les épingles, consultez Propriétés de filtre, d’épingle et de nœud.

Syntaxe

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

Paramètres

[in] Irp

Spécifie un pointeur vers une structure de paquets de demandes d’E/S (IRP). Pour plus d’informations sur les runtimes d’intégration, consultez Paquets de demandes d’IRP et d’E/S.

[in] Pin

Spécifie un pointeur vers la broche KS (Kernel Streaming) sous-jacente.

[out] Data

Spécifie un pointeur vers la mémoire tampon qui contient les données de la GetPinName méthode .

Valeur retournée

La GetPinName méthode retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié.

Remarques

Si un client a besoin du nom d’épingle actuel d’un point de terminaison, mais qu’il a déterminé que le pilote miniport ne prend pas en charge la GetPinName méthode, le client utilise le nom convivial de la broche de pont de topologie. Pour plus d’informations sur les catégories d’épingles et les noms conviviaux, consultez Propriété de catégorie d’épingler et Noms conviviaux pour les appareils de point de terminaison audio.

Pour plus d’informations sur l’un des sujets suivants :

Note Dans Windows 7, la pile audio en mode utilisateur ne prend pas en charge la personnalisation du nom du point de terminaison Haut-parleurs. Ainsi, dans Windows 7, la GetPinName méthode fonctionne uniquement avec les points de terminaison qui n’ont pas le nom convivial Speakers. La liste suivante présente les catégories de types de nœud KS auxquelles le nom convivial Speakers est attribué :

KSNODETYPE_SPEAKER

KSNODETYPE_DESKTOP_SPEAKER

KSNODETYPE_ROOM_SPEAKER

KSNODETYPE_LOW_FREQUENCY_EFFECTS_SPEAKER

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 7 et versions ultérieures de Windows.
Plateforme cible	Universal
En-tête	portcls.h (include Portcls.h)
IRQL	PASSIVE_LEVEL.