EVT_ACX_PIN_RETRIEVE_NAME funzione di callback (acxpin.h)

Articolo
02/22/2024

La EVT_ACX_PIN_RETRIEVE_NAME funzione di callback viene implementata dal driver e viene chiamata quando viene richiesto il nome per il pin specificato.

Sintassi

EVT_ACX_PIN_RETRIEVE_NAME EvtAcxPinRetrieveName;

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

Parametri

Pin

Oggetto ACXPIN che rappresenta il pin specifico per il quale viene richiesto il nome.

Name

Puntatore a una stringa Unicode da popolare con il nome del pin richiesto.

Valore restituito

EVT_ACX_PIN_RETRIEVE_NAME restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore NTSTATUS .

Commenti

ACX prea alloca il buffer UNICODE_STRING prima di richiamare questo callback. Il numero massimo di wchars per il nome è MAX_PATH non incluso il carattere di terminazione NULL. Il driver è responsabile della copia del nome nel buffer e dell'aggiornamento del campo Lunghezza struct Unicode al numero di byte utilizzati dalla stringa del nome, non incluso il carattere di terminazione NULL.

Requisiti di ACX

Versione minima di ACX: 1.0

Per altre informazioni sulle versioni ACX, vedere La panoramica della versione di ACX.

Requisiti

Requisito	Valore
Intestazione	acxpin.h
IRQL	PASSIVE_LEVEL

Vedi anche

[intestazione acxpin.h] (index.md)

Condividi tramite