EVT_ACX_PIN_RETRIEVE_NAME fonction de rappel (acxpin.h)

Article
02/26/2024

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 le code pin spécifié.

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 retournée

EVT_ACX_PIN_RETRIEVE_NAME retourne STATUS_SUCCESS si l’appel a réussi. Sinon, il 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 est MAX_PATH ne comprend pas la terminaison NULL. Le pilote est responsable de la copie du nom dans la mémoire tampon et de la mise à jour du champ Longueur du struct Unicode avec le nombre d’octets utilisés par la chaîne de nom, sans inclure la terminaison NULL.

Configuration requise d’ACX

Version minimale d’ACX : 1.0

Pour plus d’informations sur les versions d’ACX, consultez Vue d’ensemble des versions d’ACX.

Configuration requise

Condition requise	Valeur
En-tête	acxpin.h
IRQL	PASSIVE_LEVEL

Voir aussi

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

Partager via