Función StorPortMarkDumpMemory (storport.h)
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.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 8 |
| Plataforma de destino | Universal |
| Encabezado | storport.h (incluya Storport.h) |
| IRQL | Any |