Compartilhar via


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.

Retornar valor

Nenhum

Comentários

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

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

Após o retorno do WdfInterruptGetInfo , o driver pode identificar objetos de interrupção de nível passivo examinando o membro Irql 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 gerenciamento de energia e PnP.

Para obter mais informações sobre como lidar com interrupções em drivers baseados em estrutura, consulte Tratamento de 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

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Versão mínima do UMDF 2,0
Cabeçalho wdfinterrupt.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
Regras de conformidade de DDI DriverCreate(kmdf)

Confira também

EvtDevicePrepareHardware

EvtDeviceReleaseHardware

WDF_INTERRUPT_INFO

WDF_INTERRUPT_INFO_INIT