Función PoFxPowerOnCrashdumpDevice (wdm.h)

  • Artículo

La rutina PoFxPowerOnCrashdumpDevice solicita que se active un dispositivo de volcado de memoria.

Sintaxis

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

Parámetros

[in] Handle

Identificador que representa el registro del dispositivo de volcado de memoria con el marco de administración de energía de Windows (PoFx). El controlador de dispositivo recibió previamente este identificador de la rutina PoFxRegisterDevice .

[in, optional] Context

Puntero a un contexto específico del dispositivo. Este puntero se pasa como parámetro de entrada a la rutina de devolución de llamada PowerOnDumpDeviceCallback implementada por el complemento de extensión de plataforma (PEP) para el dispositivo. La información de contexto se almacena en un formato definido por el controlador de dispositivo y que el PEP entiende. Este contexto es opaco para el sistema operativo. El controlador puede establecer este parámetro en NULL si el PEP no requiere un contexto.

Valor devuelto

PoFxPowerOnCrashdumpDevice devuelve STATUS_SUCCESS si la rutina se activa correctamente en el dispositivo. Entre los posibles valores devueltos de error se incluyen los siguientes códigos de estado.

Valor devuelto Descripción
STATUS_INVALID_PARAMETER
 No es un valor de identificador válido.
STATUS_UNSUCCESSFUL
 El PEP de este dispositivo no implementa una rutina de devolución de llamada PowerOnDumpDeviceCallback ; o el PEP no pudo activar el dispositivo.

Comentarios

El controlador de un dispositivo de volcado de memoria llama a esta rutina para solicitar que el complemento de extensión de plataforma (PEP) active el dispositivo para que se pueda guardar un volcado de memoria. Todos los dispositivos de la cadena de dispositivos de volcado de memoria (que pueden incluir un controlador de almacenamiento, un controlador PCI, etc.) deben estar activados antes de que se pueda escribir un archivo de volcado de memoria en el disco.

Para obtener más información sobre los volcados de memoria, consulte Archivos de volcado de modo kernel.

Se puede llamar a esta rutina en IRQL <= HIGH_LEVEL.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible a partir de Windows 8.1.
Plataforma de destino Windows
Encabezado wdm.h (incluya Pepfx.h)
Library Ntoskrnl.lib
IRQL <= HIGH_LEVEL

Consulte también

PoFxRegisterDevice

PowerOnDumpDeviceCallback