enumeração WDF_RELEASE_HARDWARE_ORDER_ON_FAILURE (wdfdevice.h)

  • Artigo

[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.

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 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 ter chamado a função EvtDeviceReleaseHardware para todos os dispositivos filho que o driver enumera. Para obter mais informações, consulte Comentários.
WdfReleaseHardwareOrderOnFailureAfterDescendants
A estrutura sempre chama a função de retorno de chamada EvtDeviceReleaseHardware do driver depois de ter chamado a função EvtDeviceReleaseHardware para todos os dispositivos filho que o driver enumera.

Comentários

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á o EvtDeviceReleaseHardware do driver 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 ligar ou desligar o dispositivo, a estrutura pode chamar o EvtDeviceReleaseHardware do driver antes de chamar as funções EvtDeviceReleaseHardware para todos os dispositivos filho.

Se um driver especificar WdfReleaseHardwareOrderOnFailureAfterDescendants, a estrutura aguardará para chamar o EvtDeviceReleaseHardware do driver 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)

Confira também

EvtDeviceReleaseHardware

WdfDeviceInitSetReleaseHardwareOrderOnFailure