Función StorPortMarkDumpMemory (storport.h)
Un minipuerto debe marcar la memoria utilizada para el archivo de volcado 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 longitud de dirección y 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. 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. |
Observaciones
Solo se debe llamar a la rutina de StorPortMarkDumpMemory en su DriverEntry o rutinas de HwStorFindAdapter.
Si longitud = 0, se marca la sección completa que contiene dirección.
Los controladores de miniport deben llamar a storPortMarkDumpMemory para asegurarse de que se identifica la memoria usada por el miniport 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 | Valor |
|---|---|
| cliente mínimo admitido | Windows 8 |
| de la plataforma de destino de | Universal |
| encabezado de | storport.h (incluya Storport.h) |
| irQL | Cualquier |