enumeração WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE (wdfdevice.h)

Artigo
02/07/2025

[Aplica-se a KMDF e UMDF]

A enumeração WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE especifica quando a estrutura chama a função de retorno de chamada EvtDeviceReleaseHardware de um driver.

Sintaxe

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 do sistema.
`WdfReleaseHardwareOrderOnFailureEarly` Exceto em determinadas condições de erro, a estrutura chama a função de retorno de chamada EvtDeviceReleaseHardware do driver depois de chamar a função de EvtDeviceReleaseHardware para todos os dispositivos filho enumerados pelo driver. Para obter mais informações, consulte Comentários.
`WdfReleaseHardwareOrderOnFailureAfterDescendants` A estrutura sempre chama a função de retorno de chamada do driver EvtDeviceReleaseHardware depois de ter chamado a função EvtDeviceReleaseHardware para todos os dispositivos filho enumerados pelo driver.

Observações

A enumeração WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE é usada como entrada para WdfDeviceInitSetReleaseHardwareOrderOnFailure.

Se um driver especificar WdfReleaseHardwareOrderOnFailureEarly, em seguida, na remoção normal do dispositivo, a estrutura chamará a função do driver EvtDeviceReleaseHardware depois de ter chamado a função EvtDeviceReleaseHardware para todos os dispositivos filho que o driver enumera. No entanto, no caso de uma falha de energia ou de energia do dispositivo, a estrutura pode chamar o do driver EvtDeviceReleaseHardware antes de chamar o EvtDeviceReleaseHardware funções para todos os dispositivos filho.

Se um driver especificar WdfReleaseHardwareOrderOnFailureAfterDescendants, a estrutura aguardará para chamar o do driver EvtDeviceReleaseHardware até que ele tenha chamado as funções EvtDeviceReleaseHardware dos dispositivos filho.

Requisitos

Requisito	Valor
versão mínima do KMDF	1.11
versão mínima do UMDF	2.0
cabeçalho	wdfdevice.h (inclua Wdf.h)

Consulte também

EvtDeviceReleaseHardware

WdfDeviceInitSetReleaseHardwareOrderOnFailure

Compartilhar via