EVT_ACX_PIN_RETRIEVE_NAME fonction de rappel (acxpin.h)

Article
02/06/2025

La fonction de rappel EVT_ACX_PIN_RETRIEVE_NAME est implémentée par le pilote et est appelée lorsque le nom est demandé pour la broche spécifiée.

Syntaxe

EVT_ACX_PIN_RETRIEVE_NAME EvtAcxPinRetrieveName;

NTSTATUS EvtAcxPinRetrieveName(
  ACXPIN Pin,
  PUNICODE_STRING Name
)
{...}

Paramètres

Pin

Objet ACXPIN représentant la broche spécifique pour laquelle le nom est demandé.

Name

Pointeur vers une chaîne Unicode à remplir avec le nom d’épingle demandé.

Valeur de retour

EVT_ACX_PIN_RETRIEVE_NAME retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur NTSTATUS.

Remarques

ACX préalloue la mémoire tampon UNICODE_STRING avant d’appeler ce rappel. Le nombre maximal de wchars pour le nom n’est MAX_PATH pas l’indicateur de fin NULL. Le pilote est chargé de copier le nom dans la mémoire tampon et de mettre à jour le struct Unicode Champ Longueur au nombre d’octets utilisés par la chaîne de nom, et non pas à la fin NULL.

Configuration requise pour ACX

version minimale d’ACX : 1.0

Pour plus d’informations sur les versions ACX, consultez vue d’ensemble de la version ACX.

Exigences

Exigence	Valeur
d’en-tête	acxpin.h
IRQL	PASSIVE_LEVEL

Voir aussi

[en-tête acxpin.h](index.md)

Partager via