StorPortEtwLogError, fonction (storport.h)

Article
02/27/2024

StorPortEtwLogError enregistre un événement de suivi d’événements pour Windows (ETW) pour une erreur de protocole matériel.

Syntaxe

ULONG StorPortEtwLogError(
  [in]           PVOID         HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS Address,
  [in]           ULONG         Id,
  [in]           PWSTR         Description,
  [in]           ULONG         DataBufferLength,
  [in]           PVOID         DataBuffer
);

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension d’appareil du miniport.

[in, optional] Address

Adresse du périphérique d’unité de stockage. Ce paramètre est NULL pour les périphériques adaptateurs.

[in] Id

ID d’événement défini par miniport qui identifie l’événement de manière unique.

[in] Description

Texte de description de l’erreur. Ce paramètre est obligatoire.

[in] DataBufferLength

Taille de DataBuffer, en octets.

[in] DataBuffer

Mémoire tampon de taille variable qui contient des données binaires spécifiques au pilote qui sont utiles pour identifier la cause de l’erreur. Les pilotes doivent spécifier la taille de cette mémoire tampon dans le paramètre DataBufferLength .

Valeur retournée

Cette fonction retourne l’un des codes status suivants.

Code de retour	Description
STOR_STATUS_SUCCESS	L’événement a été correctement journalisé.
STOR_STATUS_INVALID_PARAMETER	Description ou DataBuffer ont la valeur NULL, ou DataBufferLength n’est pas supérieur à zéro.
STOR_STATUS_UNSUCCESSFUL	StorPort n’a pas pu journaliser l’événement ETW pour d’autres raisons, telles que la journalisation ETW n’est pas activée.

Remarques

Un miniport peut appeler StorPortEtwLogError pour journaliser un événement ETW en cas d’erreur de protocole matériel. Les événements générés à partir de cette fonction sont publiés sur le canal ETW « Microsoft-Windows-Storage-Storport/Operational ».