Funzione NdisWriteErrorLogEntry (ndis.h)

  • Articolo

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)

Vedi anche

MiniportInitializeEx

MiniportResetEx

NdisMSetMiniportAttributes