NdisWriteErrorLogEntry, fonction (ndis.h)

NdisWriteErrorLogEntry écrit une entrée dans le fichier journal des erreurs d’E/S système.

Syntaxe

void NdisWriteErrorLogEntry(
  [in] NDIS_HANDLE     NdisAdapterHandle,
  [in] NDIS_ERROR_CODE ErrorCode,
  [in] ULONG           NumberOfErrorValues,
       ...             
);

Paramètres

[in] NdisAdapterHandle

Spécifie le handle représentant la carte réseau qui est la cause de l’erreur d’E/S à consigner. Ce handle est un paramètre d’entrée de MiniportInitializeEx.

[in] ErrorCode

Spécifie le code NDIS_ERROR_CODE_XXX qui décrit le mieux l’erreur d’E/S comme l’une des valeurs suivantes :

NDIS_ERROR_CODE_RESOURCE_CONFLICT

Le pilote n’a pas pu accéder à une ressource requise.

NDIS_ERROR_CODE_OUT_OF_RESOURCES

Le matériel ou le pilote a manqué de ressources.

NDIS_ERROR_CODE_HARDWARE_FAILURE

Le pilote a détecté une erreur matérielle.

NDIS_ERROR_CODE_ADAPTER_NOT_FOUND

La carte réseau est introuvable.

NDIS_ERROR_CODE_INTERRUPT_CONNECT

L’inscription d’interruption a échoué.

NDIS_ERROR_CODE_DRIVER_FAILURE

Une défaillance de pilote qui ne correspond à aucune des autres conditions d’erreur s’est produite.

NDIS_ERROR_CODE_BAD_VERSION

Le pilote a détecté une incompatibilité de version.

NDIS_ERROR_CODE_TIMEOUT

Un délai d’expiration a expiré.

NDIS_ERROR_CODE_NETWORK_ADDRESS

Une adresse réseau n’est pas valide.

NDIS_ERROR_CODE_UNSUPPORTED_CONFIGURATION

La configuration du pilote demandée n’est pas prise en charge.

NDIS_ERROR_CODE_INVALID_VALUE_FROM_ADAPTER

Le matériel de la carte réseau a fourni une valeur non valide.

NDIS_ERROR_CODE_MISSING_CONFIGURATION_PARAMETER

Il manque un paramètre de configuration de pilote dans le Registre.

NDIS_ERROR_CODE_BAD_IO_BASE_ADDRESS

L’adresse de base des E/S pour le matériel de la carte réseau n’est pas valide.

NDIS_ERROR_CODE_RECEIVE_SPACE_SMALL

La quantité de mémoire tampon de réception disponible est trop petite pour recevoir des données.

NDIS_ERROR_CODE_ADAPTER_DISABLED

Le matériel de la carte réseau est désactivé.

[in] NumberOfErrorValues

Spécifie le nombre de valeurs ULONG à suivre pour ce paramètre.

...

Spécifie un tableau de taille variable d’ULONG associés à l’erreur à consigner.

Valeur de retour

None

Remarques

NdisWriteErrorLogEntry alloue un enregistrement de journal des erreurs d’E/S, remplit l’enregistrement avec les informations fournies sur l’erreur, puis écrit l’enregistrement dans le fichier journal des erreurs d’E/S.

Le système place une limite à la taille potentielle d’un enregistrement de journal des erreurs. Pour Windows 2000 et versions ultérieures, la limite est définie comme ERROR_LOG_MAXIMUM_SIZE. La valeur NumberOfErrorValues passée à NdisWriteErrorLogEntry a donc une limite appliquée par le système, qui est considérablement inférieure à la valeur maximale possible pour un ULONG.

Dans la pratique, peu d’appelants de NdisWriteErrorLogEntry approchent même la limite pour NumberOfErrorValues , car la fourniture de nombreuses valeurs NDIS_STATUS_XXX supplémentaires n’est pas particulièrement utile pour l’utilisateur ou l’administrateur système qui lit ultérieurement le journal des erreurs, à l’aide de l’observateur d’événements Win32. La journalisation d’une erreur d’E/S à chaque occasion n’est pas particulièrement utile pour les utilisateurs. Par conséquent, un pilote miniport doit consigner uniquement les erreurs d’E/S critiques qui peuvent aider un utilisateur ou un administrateur système à déboguer une défaillance réseau pour laquelle la carte réseau est responsable sur un ordinateur particulier ou un conflit de ressources de configuration découvert lors de l’initialisation du pilote.

En général, un pilote miniport appelle NdisWriteErrorLogEntry pendant l’initialisation à partir de sa fonction MiniportInitializeEx s’il ne peut pas initialiser une carte réseau qu’il contrôle ou ne peut pas allouer les ressources matérielles dont il a besoin pour effectuer des opérations d’E/S sur une carte réseau. Un pilote miniport peut également appeler NdisWriteErrorLogEntry lorsqu’une opération de réinitialisation de périphérique échoue en raison d’erreurs matérielles irrécupérables. La journalisation de ces types d’erreurs d’E/S aide les utilisateurs ou les administrateurs système à identifier une carte réseau mal configurée ou une carte réseau avec des composants matériels défaillants.

Configuration requise

Voir aussi

MiniportInitializeEx

MiniportResetEx

NdisMSetMiniportAttributes