Função PoFxRegisterCrashdumpDevice (wdm.h)
A rotina PoFxRegisterCrashdumpDevice registra um dispositivo de despejo de memória.
Sintaxe
NTSTATUS PoFxRegisterCrashdumpDevice(
POHANDLE Handle
);
Parâmetros
Handle
Um identificador que representa o registro do dispositivo de despejo de memória com a PoFx ( estrutura de gerenciamento de energia ) do Windows. O driver de dispositivo recebeu anteriormente esse identificador da rotina PoFxRegisterDevice .
Retornar valor
PoFxRegisterCrashdumpDevice retornará STATUS_SUCCESS se a rotina registrar com êxito o dispositivo de despejo de memória. Os possíveis valores retornados por erro incluem os seguintes códigos de status.
| Valor retornado | Descrição |
|---|---|
|
Não é um valor de identificador válido. |
|
Não há PEP para este dispositivo. |
Comentários
Essa rotina é chamada pelo driver de um dispositivo de despejo de memória para informar à PoFx que o dispositivo faz parte da cadeia de dispositivos de despejo de memória. Vários dispositivos (controlador de armazenamento, controlador PCI e assim por diante) podem precisar ser ativados para que o kernel do Windows possa gravar um arquivo de despejo de memória no disco. Quando ocorre um erro fatal do sistema, o kernel tenta ativar os dispositivos de despejo de memória e salvar o arquivo de despejo de memória.
O driver deve chamar PoFxRegisterDevice para registrar o dispositivo com PoFx antes de chamar PoFxRegisterCrashdumpDevice.
O driver de um dispositivo de despejo de memória pode chamar a rotina PoFxPowerOnCrashdumpDevice para solicitar que o PEP ligue o dispositivo.
Para obter mais informações sobre despejos de memória, consulte Arquivos de despejo no modo Kernel.
PoFxRegisterCrashdumpDevice deve ser chamado em IRQL = PASSIVE_LEVEL.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 8.1. |
| Plataforma de Destino | Windows |
| Cabeçalho | wdm.h (inclua Pepfx.h) |
| Biblioteca | Ntoskrnl.lib |
| IRQL | PASSIVE_LEVEL |