Función PoFxRegisterCrashdumpDevice (wdm.h)

  • Artículo

La rutina PoFxRegisterCrashdumpDevice registra un dispositivo de volcado de memoria.

Sintaxis

NTSTATUS PoFxRegisterCrashdumpDevice(
  POHANDLE Handle
);

Parámetros

Handle

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

Valor devuelto

PoFxRegisterCrashdumpDevice devuelve STATUS_SUCCESS si la rutina registra correctamente el dispositivo de volcado de memoria. 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
 No hay PEP para este dispositivo.

Comentarios

El controlador llama a esta rutina para que un dispositivo de volcado de memoria informe a PoFx de que el dispositivo forma parte de la cadena de dispositivos de volcado de memoria. Es posible que varios dispositivos (controlador de almacenamiento, controlador PCI, etc.) deban activarse para que el kernel de Windows pueda escribir un archivo de volcado de memoria en el disco. Cuando se produce un error grave del sistema, el kernel intenta activar los dispositivos de volcado de memoria y guardar el archivo de volcado de memoria.

El controlador debe llamar a PoFxRegisterDevice para registrar el dispositivo con PoFx antes de llamar a PoFxRegisterCrashdumpDevice.

El controlador de un dispositivo de volcado de memoria puede llamar a la rutina PoFxPowerOnCrashdumpDevice para solicitar que el PEP active el dispositivo.

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

Se debe llamar a PoFxRegisterCrashdumpDevice en IRQL = PASSIVE_LEVEL.

Requisitos

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

Consulte también

PoFxPowerOnCrashdumpDevice

PoFxRegisterDevice