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 del pin 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 .

Comentarios

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 actualizar el campo Longitud de estructura Unicode 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
Header	acxpin.h
IRQL	PASSIVE_LEVEL

Consulte también

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