StorPortCaptureLiveDump, fonction (storport.h)

Article
02/07/2025

StorPortCaptureLiveDump capture un fichier de vidage en direct.

Syntaxe

ULONG StorPortCaptureLiveDump(
  [in]          PVOID                      HwDeviceExtension,
  [in/optional] PSTOR_ADDRESS              StorAddress,
  [in]          PSTORPORT_CAPTURE_LIVEDUMP CaptureLivedump
);

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension d’appareil matériel du miniport.

[in/optional] StorAddress

Pointeur vers une structure STOR_ADDRESS qui contient l’adresse spécifiant l’objet d’unité. Définissez StorAddress sur NULL si l’appareil est un adaptateur.

[in] CaptureLivedump

Pointeur vers une structure STORPORT_CAPTURE_LIVEDUMP contenant les données nécessaires pour générer le vidage en direct.

Valeur de retour

StorPortCaptureLiveDump retourne l’une des valeurs suivantes :

Retourner le code	Description
STOR_STATUS_SUCCESS	La liste des fonctionnalités de vidage a été correctement définie.
STOR_STATUS_INVALID_PARAMETER	Un ou plusieurs des paramètres fournis ne sont pas valides.
STOR_STATUS_UNSUCCESSFUL	Retourné pour d’autres raisons système internes.

Remarques

Lorsqu’un miniport détecte un problème qui peut nécessiter un tri supplémentaire, il peut appeler StorPortCaptureLiveDump pour capturer un fichier de vidage en direct.

Cette fonction doit être appelée à PASSIVE_LEVEL.