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

Article
02/07/2025

La méthode GetPinName récupère le nom convivial d’un point de terminaison audio. Pour plus d’informations sur les broches, 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 irPs, consultez IRP et paquets de requête 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 méthode GetPinName.

Valeur de retour

La méthode GetPinName 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 de broche actuel d’un point de terminaison, mais a déterminé que le pilote miniport ne prend pas en charge la méthode GetPinName, 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é pin category et Friendly Names for Audio Endpoint Devices.

Pour plus d’informations sur

Remarque dans Windows 7, la pile audio en mode utilisateur ne prend pas en charge la personnalisation du nom du point de terminaison haut-parleurs. Par conséquent, dans Windows 7, la méthode GetPinName fonctionne uniquement avec les points de terminaison qui n’ont pas le nom convivial des haut-parleurs. La liste suivante montre les catégories de type de nœud KS qui ont le nom convivial des haut-parleurs :

KSNODETYPE_SPEAKER

KSNODETYPE_DESKTOP_SPEAKER

KSNODETYPE_ROOM_SPEAKER

KSNODETYPE_LOW_FREQUENCY_EFFECTS_SPEAKER

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows 7 et versions ultérieures de Windows.
plateforme cible	Universel
d’en-tête	portcls.h (include Portcls.h)
IRQL	PASSIVE_LEVEL.