Funzione NdisWriteErrorLogEntry (ndis.h)
NdisWriteErrorLogEntry scrive una voce nel file di log degli errori di I/O di sistema.
Sintassi
void NdisWriteErrorLogEntry(
[in] NDIS_HANDLE NdisAdapterHandle,
[in] NDIS_ERROR_CODE ErrorCode,
[in] ULONG NumberOfErrorValues,
...
);
Parametri
[in] NdisAdapterHandle
Specifica l'handle che rappresenta la scheda di interfaccia di rete che è la causa dell'errore di I/O da registrare. Questo handle è un parametro di input per MiniportInitializeEx.
[in] ErrorCode
Specifica il codice NDIS_ERROR_CODE_XXX che descrive meglio l'errore di I/O come uno dei valori seguenti:
NDIS_ERROR_CODE_RESOURCE_CONFLICT
Il driver non è riuscito ad accedere a una risorsa necessaria.
NDIS_ERROR_CODE_OUT_OF_RESOURCES
L'hardware o il driver ha esaurito le risorse.
NDIS_ERROR_CODE_HARDWARE_FAILURE
Il driver ha rilevato un errore hardware.
NDIS_ERROR_CODE_ADAPTER_NOT_FOUND
La scheda di rete non è stata trovata.
NDIS_ERROR_CODE_INTERRUPT_CONNECT
La registrazione di interrupt non è riuscita.
NDIS_ERROR_CODE_DRIVER_FAILURE
Si è verificato un errore del driver che non corrisponde ad alcuna delle altre condizioni di errore.
NDIS_ERROR_CODE_BAD_VERSION
Il driver ha rilevato una mancata corrispondenza della versione.
NDIS_ERROR_CODE_TIMEOUT
Timeout scaduto.
NDIS_ERROR_CODE_NETWORK_ADDRESS
Un indirizzo di rete non è valido.
NDIS_ERROR_CODE_UNSUPPORTED_CONFIGURATION
La configurazione del driver richiesta non è supportata.
NDIS_ERROR_CODE_INVALID_VALUE_FROM_ADAPTER
L'hardware della scheda di rete ha fornito un valore non valido.
NDIS_ERROR_CODE_MISSING_CONFIGURATION_PARAMETER
Nel Registro di sistema manca un parametro di configurazione del driver.
NDIS_ERROR_CODE_BAD_IO_BASE_ADDRESS
L'indirizzo di base di I/O per l'hardware della scheda di rete non è valido.
NDIS_ERROR_CODE_RECEIVE_SPACE_SMALL
La quantità di memoria del buffer di ricezione disponibile è troppo piccola per ricevere i dati.
NDIS_ERROR_CODE_ADAPTER_DISABLED
L'hardware della scheda di rete è disabilitato.
[in] NumberOfErrorValues
Specifica il numero di valori ULONG da seguire.
...
Specifica una matrice di ULONG a dimensione variabile associata all'errore da registrare.
Valore restituito
nessuno
Osservazioni
NdisWriteErrorLogEntry alloca un record del log degli errori di I/O, compila il record con le informazioni fornite sull'errore e quindi scrive il record nel file di log degli errori di I/O.
Il sistema inserisce un limite per le dimensioni potenziali di un record del log degli errori. Per Windows 2000 e versioni successive, il limite viene definito come ERROR_LOG_MAXIMUM_SIZE. NumberOfErrorValues passato a NdisWriteErrorLogEntry ha quindi un limite imposto dal sistema, che è notevolmente inferiore al valore massimo possibile per una ULONG.
In pratica, alcuni chiamanti di NdisWriteErrorLogEntry addirittura si avvicinano al limite per NumberOfErrorValues perché fornire molti valori aggiuntivi NDIS_STATUS_XXX non è particolarmente utile per l'utente o l'amministratore di sistema che successivamente legge il log degli errori, usando il Visualizzatore eventi Win32. La registrazione di un errore di I/O a ogni possibile opportunità non è particolarmente utile per gli utenti, pertanto un driver miniport deve registrare solo errori di I/O critici che possono aiutare un utente o un amministratore di sistema a eseguire il debug di un errore di rete per il quale la scheda di interfaccia di rete è responsabile di un computer specifico o di un conflitto di risorse di configurazione individuato durante l'inizializzazione del driver.
In generale, un driver miniport chiama NdisWriteErrorLogEntry durante l'inizializzazione dalla funzione MiniportInitializeEx se non è in grado di inizializzare una scheda di interfaccia di rete che controlla o non può allocare le risorse hardware necessarie per eseguire operazioni di I/O su una scheda di interfaccia di rete. Un driver miniport può anche chiamare NdisWriteErrorLogEntry quando un'operazione di reimpostazione del dispositivo non riesce a causa di errori hardware irreversibili. La registrazione di questi tipi di errori di I/O consente agli utenti o agli amministratori di sistema di identificare una scheda di interfaccia di rete non configurata correttamente o una scheda di interfaccia di rete con componenti hardware non riusciti.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisWriteErrorLogEntry (NDIS 5.1)) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisWriteErrorLogEntry (NDIS 5.1)) in Windows XP. |
| Piattaforma di destinazione | Universale |
| Intestazione | ndis.h (include Ndis.h) |
| Libreria | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| Regole di conformità DDI | Irql_Miscellaneous_Function(ndis) |