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) |