StorPortEtwLogError, fonction (storport.h)

Article
02/07/2025

StorPortEtwLogError journalise un événement 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 de l’unité de stockage. Ce paramètre a la valeur NULL pour les périphériques d’adaptateur.

[in] Id

ID d’événement défini par miniport qui identifie de façon unique l’événement.

[in] Description

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

[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 est utile 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 de retour

Cette fonction retourne l’un des codes d’état suivants.

Retourner le code	Description
STOR_STATUS_SUCCESS	L’événement a été correctement journalisé.
STOR_STATUS_INVALID_PARAMETER	Description ou DataBuffer sont NULL, ou DataBufferLength n’est pas supérieure à zéro.
STOR_STATUS_UNSUCCESSFUL	StorPort n’a pas pu journaliser l’événement ETW pour d’autres raisons, comme la journalisation ETW n’est pas activée.

Remarques

Un miniport peut appeler StorPortEtwLogError pour consigner un événement ETW pour une 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 ».