EVT_ACX_PIN_RETRIEVE_NAME funzione di callback (acxpin.h)

  • Articolo

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)