Funzione StorPortMarkDumpMemory (storport.h)

Articolo
02/29/2024

Un miniport deve contrassegnare la memoria usata per il file dump o il file di ibernazione. La memoria contrassegnata viene mantenuta e rimane valida dopo una ripresa dall'operazione di ibernazione. La memoria da contrassegnare viene specificata da un indirizzo e dalla lunghezza dell'intervallo in una chiamata a StorPortMarkDumpMemory.

Sintassi

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

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo hardware per l'adattatore del bus host (HBA).

[in] Address

Indirizzo iniziale dell'intervallo di memoria da contrassegnare.

[in] Length

Lunghezza dell'intervallo di memoria contrassegnato.

[in] Flags

Contrassegni di memoria dump. Il parametro Flags deve essere 0 o contenere solo il valore seguente.

Valore	Significato
MARK_DUMP_MEMORY_FLAG_PHYSICAL_ADDRESS	L'indirizzo fornito in Address è un indirizzo fisico e non un indirizzo virtuale di sistema.

Valore restituito

StorPortMarkDumpMemory restituisce uno dei codici di stato seguenti:

Codice restituito	Descrizione
STOR_STATUS_SUCCESS	Indica che la routine imposta correttamente gli attributi dell'unità.
STOR_STATUS_INVALID_PARAMETER	Un valore di flag non valido è stato specificato nel parametro Flags .

Commenti

La routine StorPortMarkDumpMemory deve essere chiamata solo da un driver miniport nelle routine DriverEntry o HwStorFindAdapter .

Se Length = 0, l'intera sezione contenente Address è contrassegnata.

I driver Miniport devono chiamare StorPortMarkDumpMemory per assicurarsi che la memoria utilizzata dal miniport per generare il file di dump o il file di ibernazione sia identificato. Almeno, i miniport devono chiamare StorPortMarkDumpMemory quando il membro DumpMode di PORT_CONFIGURATION_INFORMATION è impostato su DUMP_MODE_MARK_MEMORY o DUMP_MODE_HIBER.