EVT_ACX_PIN_RETRIEVE_NAME función de devolución de llamada (acxpin.h)

El controlador implementa la función de devolución de llamada EVT_ACX_PIN_RETRIEVE_NAME y se llama cuando se solicita el nombre para el pin especificado.

Sintaxis

EVT_ACX_PIN_RETRIEVE_NAME EvtAcxPinRetrieveName;

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

Parámetros

Pin

Objeto ACXPIN que representa el pin específico para el que se solicita el nombre.

Name

Puntero a una cadena Unicode que se va a rellenar con el nombre de patilla solicitado.

Valor devuelto

EVT_ACX_PIN_RETRIEVE_NAME devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error NTSTATUS.

Observaciones

ACX asigna previamente el búfer de UNICODE_STRING antes de invocar esta devolución de llamada. El número máximo de wchars para el nombre es MAX_PATH no incluir el terminador NULL. El controlador es responsable de copiar el nombre en el búfer y de actualizar la estructura Unicode campo Longitud al número de bytes usados por la cadena de nombre, no incluido el terminador NULL.

Requisitos de ACX

versión mínima de ACX: 1.0

Para obtener más información sobre las versiones de ACX, consulte introducción a la versión de ACX.

Requisitos

Requisito	Valor
encabezado de	acxpin.h
irQL	PASSIVE_LEVEL

Consulte también

• [encabezado acxpin.h](index.md)