StorPortMarkDumpMemory, fonction (storport.h)
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 de l’opération de mise en veille prolongée. La mémoire à marquer est spécifiée par une longueur d’adresse et 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 Indicateurs doit être égal à 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 de retour
StorPortMarkDumpMemory retourne l’un des codes d’état suivants :
| Retourner le code | Description |
|---|---|
| STOR_STATUS_SUCCESS | Indique que la routine définit correctement les attributs d’unité. |
| STOR_STATUS_INVALID_PARAMETER | Une valeur d’indicateur non valide a été spécifiée dans le paramètre Indicateurs. |
Remarques
La routine StorPortMarkDumpMemory ne doit être appelée que par un pilote miniport dans sonDriverEntryou routines HwStorFindAdapter.
Si Longueur = 0, la section entière contenant Adresse est marquée.
Les pilotes miniport doivent appeler StorPortMarkDumpMemory pour vous assurer que la mémoire utilisée par le miniport pour générer le fichier de vidage ou le fichier de veille prolongée est identifié. 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 8 |
| plateforme cible | Universel |
| d’en-tête | storport.h (include Storport.h) |
| IRQL | Quelconque |