Função PoFxPowerOnCrashdumpDevice (wdm.h)

A rotina PoFxPowerOnCrashdumpDevice solicita que um dispositivo de despejo de falhas seja ativado.

Sintaxe

NTSTATUS PoFxPowerOnCrashdumpDevice(
  [in]           POHANDLE Handle,
  [in, optional] PVOID    Context
);

Parâmetros

[in] 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 do dispositivo recebeu esse identificador anteriormente da rotina PoFxRegisterDevice .

[in, optional] Context

Um ponteiro para um contexto específico do dispositivo. Esse ponteiro é passado como um parâmetro de entrada para a rotina de retorno de chamada PowerOnDumpDeviceCallback implementada pelo PEP (plug-in de extensão de plataforma) para o dispositivo. As informações de contexto são armazenadas em um formato definido pelo driver do dispositivo e são compreendidas pelo PEP. Esse contexto é opaco para o sistema operacional. O driver poderá definir esse parâmetro como NULL se o PEP não exigir um contexto.

Retornar valor

PoFxPowerOnCrashdumpDevice retorna STATUS_SUCCESS se a rotina conseguir ativar a energia para o dispositivo. Os valores de retorno de erro possíveis incluem os seguintes códigos de status.

Valor retornado	Descrição
STATUS_INVALID_PARAMETER	Não é um valor de identificador válido.
STATUS_UNSUCCESSFUL	O PEP para este dispositivo não implementa uma rotina de retorno de chamada PowerOnDumpDeviceCallback ; ou o PEP não pôde ativar o dispositivo.

Comentários

O driver de um dispositivo de despejo de memória chama essa rotina para solicitar que o PEP (plug-in de extensão de plataforma) ative o dispositivo para que um despejo de memória possa ser salvo. Todos os dispositivos na cadeia de dispositivos de despejo de falhas (que podem incluir um controlador de armazenamento, um controlador PCI e assim por diante) devem ser ativados antes que um arquivo de despejo de falha possa ser gravado em disco.

Para obter mais informações sobre despejos de memória, consulte Arquivos de despejo no modo Kernel.

Essa rotina pode ser chamada em IRQL <= HIGH_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	<= HIGH_LEVEL

Confira também

PoFxRegisterDevice

PowerOnDumpDeviceCallback