Función StorPortMarkDumpMemory (storport.h)

Artículo
03/05/2024

Un minipuerto debe marcar la memoria usada para el archivo de volcado de memoria o el archivo de hibernación. La memoria marcada se conserva y permanece válida después de una reanudación de la operación de hibernación. La memoria que se va a marcar se especifica mediante una dirección y una longitud de intervalo en una llamada a StorPortMarkDumpMemory.

Sintaxis

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

Parámetros

[in] HwDeviceExtension

Puntero a la extensión de dispositivo de hardware para el adaptador de bus host (HBA).

[in] Address

Dirección inicial del intervalo de memoria que se va a marcar.

[in] Length

Longitud del intervalo de memoria marcado.

[in] Flags

Marcas de marcado de memoria de volcado de memoria. El parámetro Flags debe ser 0 o contener solo el valor siguiente.

Valor	Significado
MARK_DUMP_MEMORY_FLAG_PHYSICAL_ADDRESS	La dirección proporcionada en Dirección es una dirección física y no una dirección virtual del sistema.

Valor devuelto

StorPortMarkDumpMemory devuelve uno de los siguientes códigos de estado:

Código devuelto	Descripción
STOR_STATUS_SUCCESS	Indica que la rutina establece correctamente los atributos de unidad.
STOR_STATUS_INVALID_PARAMETER	Se especificó un valor de marca no válido en el parámetro Flags .

Comentarios

La rutina StorPortMarkDumpMemory solo debe llamarse mediante un controlador de miniporte en sus rutinas DriverEntry o HwStorFindAdapter .

Si Length = 0, se marca la sección completa que contiene Address .

Los controladores de minipuerto deben llamar a StorPortMarkDumpMemory para asegurarse de que se identifica la memoria usada por el miniporte para generar el archivo de volcado o el archivo de hibernación. Como mínimo, los miniportes deben llamar a StorPortMarkDumpMemory cuando el miembro DumpMode de PORT_CONFIGURATION_INFORMATION esté establecido en DUMP_MODE_MARK_MEMORY o DUMP_MODE_HIBER.