Condividi tramite


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)

Vedi anche

EvtDevicePrepareHardware

EvtDeviceReleaseHardware

WDF_INTERRUPT_INFO

WDF_INTERRUPT_INFO_INIT