Função WdfInterruptGetInfo (wdfinterrupt.h)

[Aplica-se a KMDF e UMDF]

O método WdfInterruptGetInfo recupera informações sobre uma interrupção especificada.

Sintaxe

VOID WdfInterruptGetInfo(
  [in]      WDFINTERRUPT        Interrupt,
  [in, out] PWDF_INTERRUPT_INFO Info
);

Parâmetros

[in] Interrupt

Um identificador para o objeto de interrupção.

[in, out] Info

Um ponteiro para uma estrutura de WDF_INTERRUPT_INFO alocada pelo chamador que foi inicializada chamando WDF_INTERRUPT_INFO_INIT.

Valor de retorno

Nenhum

Observações

Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.

O método WdfInterruptGetInfo só poderá obter informações de interrupção se o driver chamá-lo depois que a estrutura chamar a função de retorno de chamada EvtDevicePrepareHardware do driver e antes da estrutura chamar a função de retorno de chamada do driver EvtDeviceReleaseHardware.

Depois que WdfInterruptGetInfo tiver retornado, o driver poderá identificar objetos de interrupção de nível passivo examinando o irql membro da estrutura WDF_INTERRUPT_INFO. Para objetos de interrupção de nível passivo, esse valor é PASSIVE_LEVEL.

Para obter informações sobre a ordem na qual as funções de retorno de chamada de um driver são chamadas, consulte cenários de PnP e gerenciamento de energia.

Para obter mais informações sobre como lidar com interrupções em drivers baseados em estrutura, consulte Tratando interrupções de hardware.

Exemplos

O exemplo de código a seguir inicializa uma estrutura WDF_INTERRUPT_INFO e chama WdfInterruptGetInfo.

WDF_INTERRUPT_INFO  Info;

WDF_INTERRUPT_INFO_INIT(&Info);
WdfInterruptGetInfo(
                    Interrupt,
                    &Info
                    );

Requisitos

Consulte também

EvtDevicePrepareHardware

EvtDeviceReleaseHardware

WDF_INTERRUPT_INFO

WDF_INTERRUPT_INFO_INIT