Fonction StorPortMarkDumpMemory (storport.h)

Article
02/26/2024

Un miniport doit marquer la mémoire utilisée pour le fichier de vidage ou le fichier de mise en veille prolongée. La mémoire marquée est conservée et reste valide après une reprise après une opération de mise en veille prolongée. La mémoire à marquer est spécifiée par une adresse et une longueur de plage dans un appel à StorPortMarkDumpMemory.

Syntaxe

ULONG StorPortMarkDumpMemory(
  [in] PVOID     HwDeviceExtension,
  [in] PVOID     Address,
  [in] ULONG_PTR Length,
  [in] ULONG     Flags
);

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique matériel pour l’adaptateur de bus hôte (HBA).

[in] Address

Adresse de départ de la plage de mémoire à marquer.

[in] Length

Longueur de la plage de mémoire marquée.

[in] Flags

Indicateurs de marquage de mémoire de vidage. Le paramètre Flags doit être 0 ou contenir uniquement la valeur suivante.

Valeur	Signification
MARK_DUMP_MEMORY_FLAG_PHYSICAL_ADDRESS	L’adresse fournie dans Adresse est une adresse physique et non une adresse virtuelle système.

Valeur retournée

StorPortMarkDumpMemory retourne l’un des codes status suivants :

Code de retour	Description
STOR_STATUS_SUCCESS	Indique que la routine a correctement défini les attributs d’unité.
STOR_STATUS_INVALID_PARAMETER	Une valeur d’indicateur non valide a été spécifiée dans le paramètre Flags .

Remarques

La routine StorPortMarkDumpMemory doit uniquement être appelée par un pilote miniport dans ses routines DriverEntry ou HwStorFindAdapter .

Si Longueur = 0, la section entière contenant l’adresse est marquée.

Les pilotes miniport doivent appeler StorPortMarkDumpMemory pour s’assurer que la mémoire utilisée par le miniport pour générer le fichier de vidage ou le fichier de mise en veille prolongée est identifiée. Au minimum, les miniports doivent appeler StorPortMarkDumpMemory lorsque le membre DumpMode de PORT_CONFIGURATION_INFORMATION est défini sur DUMP_MODE_MARK_MEMORY ou DUMP_MODE_HIBER.