EVT_ACX_PIN_RETRIEVE_NAME funzione di callback (acxpin.h)
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 cui viene richiesto il nome.
Name
Puntatore a una stringa Unicode da popolare con il nome pin richiesto.
Valore restituito
EVT_ACX_PIN_RETRIEVE_NAME restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un NTSTATUS codice di errore.
Osservazioni
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 dello struct Unicode campo Length al numero di byte utilizzati dalla stringa del nome, senza includere il carattere di terminazione NULL.
Requisiti ACX
versione minima di ACX: 1.0
Per altre informazioni sulle versioni di ACX, vedere panoramica della versione ACX.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | acxpin.h |
| IRQL | PASSIVE_LEVEL |