enumeración WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE (wdfdevice.h)

[Se aplica a KMDF y UMDF]

La enumeración WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE especifica cuándo el marco llama a la función de devolución de llamada EvtDeviceReleaseHardware de un controlador.

Syntax

typedef enum _WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE {
  WdfReleaseHardwareOrderOnFailureInvalid = 0,
  WdfReleaseHardwareOrderOnFailureEarly,
  WdfReleaseHardwareOrderOnFailureAfterDescendants
} WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE, *PWDF_RELEASE_HARDWARE_ORDER_ON_FAILURE;

Constantes

WdfReleaseHardwareOrderOnFailureInvalid Valor: 0 Reservado para uso del sistema.
WdfReleaseHardwareOrderOnFailureEarly Excepto en determinadas condiciones de error, el marco llama a la función de devolución de llamada EvtDeviceReleaseHardware del controlador después de llamar a la función EvtDeviceReleaseHardware para todos los dispositivos secundarios que el controlador enumera. Para obtener más información, vea la sección Comentarios.
WdfReleaseHardwareOrderOnFailureAfterDescendants El marco siempre llama a la función de devolución de llamada EvtDeviceReleaseHardware del controlador después de llamar a la función EvtDeviceReleaseHardware para todos los dispositivos secundarios que el controlador enumera.

Comentarios

La enumeración WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE se usa como entrada para WdfDeviceInitSetReleaseHardwareOrderOnFailure.

Si un controlador especifica WdfReleaseHardwareOrderOnFailureEarly, en la eliminación normal del dispositivo, el marco llama al evtDeviceReleaseHardware del controlador después de llamar a la función EvtDeviceReleaseHardware para todos los dispositivos secundarios que el controlador enumera. Sin embargo, en caso de un error de encendido o apagado del dispositivo, el marco podría llamar al evtDeviceReleaseHardware del controlador antes de llamar a las funciones EvtDeviceReleaseHardware para todos los dispositivos secundarios.

Si un controlador especifica WdfReleaseHardwareOrderOnFailureAfterDescendants, el marco espera a llamar al evtDeviceReleaseHardware del controlador hasta que haya llamado a las funciones EvtDeviceReleaseHardware de los dispositivos secundarios.

Requisitos

Requisito	Value
Versión mínima de KMDF	1.11
Versión mínima de UMDF	2.0
Encabezado	wdfdevice.h (incluya Wdf.h)

Consulte también

EvtDeviceReleaseHardware

WdfDeviceInitSetReleaseHardwareOrderOnFailure