Funzione StorPortMarkDumpMemory (storport.h)

Articolo
02/07/2025

Un miniport deve contrassegnare la memoria usata per il file di 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 la scheda 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 di dump. Il parametro flag deve essere 0 o contenere solo il valore seguente.

Valore	Significato
MARK_DUMP_MEMORY_FLAG_PHYSICAL_ADDRESS	L'indirizzo specificato 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	È stato specificato un valore di flag non valido nel parametro flag.

Osservazioni

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

Se Lunghezza = 0, viene contrassegnata l'intera sezione contenente Address.

I driver Miniport devono chiamare StorPortMarkDumpMemory per assicurarsi che venga identificata la memoria usata dal miniport per generare il file di dump o il file di ibernazione. Come minimo, i miniport devono chiamare StorPortMarkDumpMemory quando il DumpMode membro di PORT_CONFIGURATION_INFORMATION è impostato su DUMP_MODE_MARK_MEMORY o DUMP_MODE_HIBER.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 8
piattaforma di destinazione	Universale
intestazione	storport.h (include Storport.h)
IRQL	Qualunque

Vedere anche

DriverEntry

HwStorFindAdapter

PORT_CONFIGURATION_INFORMATION

Condividi tramite