Função PoFxRegisterCrashdumpDevice (wdm.h)

  • Artigo

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
STATUS_INVALID_PARAMETER
 Não é um valor de identificador válido.
STATUS_UNSUCCESSFUL
 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

Confira também

PoFxPowerOnCrashdumpDevice

PoFxRegisterDevice