Funzione WdfInterruptGetInfo (wdfinterrupt.h)
[Si applica a KMDF e UMDF]
Il metodo WdfInterruptGetInfo recupera informazioni su un interrupt specificato.
Sintassi
void WdfInterruptGetInfo(
[in] WDFINTERRUPT Interrupt,
[in, out] PWDF_INTERRUPT_INFO Info
);
Parametri
[in] Interrupt
Handle per l'oggetto interrupt.
[in, out] Info
Puntatore a una struttura di WDF_INTERRUPT_INFO allocata dal chiamante inizializzata chiamando WDF_INTERRUPT_INFO_INIT.
Valore restituito
nessuno
Osservazioni
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Il metodo WdfInterruptGetInfo può ottenere informazioni di interruzione solo se il driver lo chiama dopo che il framework ha chiamato la funzione di callback EvtDevicePrepareHardware del driver e prima che il framework abbia chiamato la funzione di callback EvtDeviceReleaseHardware del driver.
Dopo la restituzione di WdfInterruptGetInfo , il driver può identificare gli oggetti interrupt a livello passivo esaminando il membro Irql della struttura WDF_INTERRUPT_INFO . Per gli oggetti interrupt a livello passivo, questo valore è PASSIVE_LEVEL.
Per informazioni sull'ordine in cui vengono chiamate le funzioni di callback di un driver, vedere Scenari di risparmio energia e PnP.
Per altre informazioni sulla gestione degli interrupt nei driver basati su framework, vedere Gestione degli interrupt hardware.
Esempio
L'esempio di codice seguente inizializza una struttura WDF_INTERRUPT_INFO e chiama WdfInterruptGetInfo.
WDF_INTERRUPT_INFO Info;
WDF_INTERRUPT_INFO_INIT(&Info);
WdfInterruptGetInfo(
Interrupt,
&Info
);
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Versione UMDF minima | 2,0 |
| Intestazione | wdfinterrupt.h (include Wdf.h) |
| Libreria | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| Regole di conformità DDI | DriverCreate(kmdf) |