Função StorPortMarkDumpMemory (storport.h)
Um miniporto deve marcar a memória usada para o arquivo de despejo ou o arquivo de hibernação. A memória marcada é retida e permanece válida após uma retomada da operação de hibernação. A memória a ser marcada é especificada por um endereço e comprimento de intervalo em uma chamada para StorPortMarkDumpMemory.
Sintaxe
ULONG StorPortMarkDumpMemory(
[in] PVOID HwDeviceExtension,
[in] PVOID Address,
[in] ULONG_PTR Length,
[in] ULONG Flags
);
Parâmetros
[in] HwDeviceExtension
Um ponteiro para a extensão do dispositivo de hardware para o HBA (adaptador de barramento de host).
[in] Address
O endereço inicial do intervalo de memória a ser marcado.
[in] Length
O comprimento do intervalo de memória marcado.
[in] Flags
Despejar sinalizadores de marcação de memória. O parâmetro Flags deve ser 0 ou conter apenas o valor a seguir.
| Valor | Significado |
|---|---|
| MARK_DUMP_MEMORY_FLAG_PHYSICAL_ADDRESS | O endereço fornecido em Endereço é um endereço físico e não um endereço virtual do sistema. |
Retornar valor
StorPortMarkDumpMemory retorna um dos seguintes códigos de status:
| Código de retorno | Descrição |
|---|---|
| STOR_STATUS_SUCCESS | Indica que a rotina define os atributos de unidade com êxito. |
| STOR_STATUS_INVALID_PARAMETER | Um valor de sinalizador inválido foi especificado no parâmetro Flags . |
Comentários
A rotina StorPortMarkDumpMemory só deve ser chamada por um driver de miniporto em suas rotinas DriverEntry ou HwStorFindAdapter .
Se Length = 0, a seção inteira que contém o Endereço será marcada.
Os drivers de miniport devem chamar StorPortMarkDumpMemory para garantir que a memória usada pelo miniporto para gerar o arquivo de despejo ou o arquivo de hibernação seja identificada. No mínimo, os miniportos devem chamar StorPortMarkDumpMemory quando o membro DumpMode do PORT_CONFIGURATION_INFORMATION estiver definido como DUMP_MODE_MARK_MEMORY ou DUMP_MODE_HIBER.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 |
| Plataforma de Destino | Universal |
| Cabeçalho | storport.h (inclua Storport.h) |
| IRQL | Qualquer |