Partager via


Fonction StorPortCaptureLiveDump (storport.h)

StorPortCaptureLiveDump capture un fichier de vidage dynamique.

Syntaxe

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

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique 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 de STORPORT_CAPTURE_LIVEDUMP contenant les données nécessaires pour générer le vidage dynamique.

Valeur retournée

StorPortCaptureLiveDump retourne l’une des valeurs suivantes :

Code de retour Description
STOR_STATUS_SUCCESS La liste des fonctionnalités de vidage a été définie avec succès.
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 au PASSIVE_LEVEL.

Configuration requise

Condition requise Valeur
Serveur minimal pris en charge Windows Server 2022
En-tête storport.h
IRQL PASSIVE_LEVEL

Voir aussi

STOR_ADDRESS

STORPORT_CAPTURE_LIVEDUMP

STORPORT_LIVEDUMP_DATA_TYPE

STORPORT_LIVEDUMP_DEVICE_TELEMETRY_LOG