Compartilhar via

EVT_ACX_PIN_RETRIEVE_NAME função de retorno de chamada (acxpin.h)

  • Artigo

A função de retorno de chamada EVT_ACX_PIN_RETRIEVE_NAME é implementada pelo driver e é chamada quando o nome é solicitado para o pin especificado.

Sintaxe

EVT_ACX_PIN_RETRIEVE_NAME EvtAcxPinRetrieveName;

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

Parâmetros

Pin

Um objeto ACXPIN que representa o pino específico para o qual o nome está sendo solicitado.

Name

Um ponteiro para uma cadeia de caracteres Unicode a ser preenchida com o nome do pino solicitado.

Retornar valor

EVT_ACX_PIN_RETRIEVE_NAME retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, ele retornará um código de erro NTSTATUS .

Comentários

O ACX pré-aloca o buffer de UNICODE_STRING antes de invocar esse retorno de chamada. O número máximo de wchars para o nome é MAX_PATH não incluindo o terminador NULL. O driver é responsável por copiar o nome no buffer e por atualizar o campo Comprimento do struct Unicode para o número de bytes usados pela cadeia de caracteres de nome, não incluindo o terminador NULL.

Requisitos do ACX

Versão mínima do ACX: 1.0

Para obter mais informações sobre versões do ACX, consulte Visão geral da versão do ACX.

Requisitos

Requisito Valor
Cabeçalho acxpin.h
IRQL PASSIVE_LEVEL

Confira também

  • [cabeçalho acxpin.h] (index.md)