Funzione WdfInterruptQueueWorkItemForIsr (wdfinterrupt.h)

[Si applica a KMDF e UMDF]

Il metodo WdfInterruptQueueWorkItemForIsr accoda una funzione di callback evtInterruptWorkItem dell'oggetto di interruzione del framework.

Sintassi

BOOLEAN WdfInterruptQueueWorkItemForIsr(
  [in] WDFINTERRUPT Interrupt
);

Parametri

[in] Interrupt

Handle per un oggetto di interruzione del framework.

Valore restituito

Se l'ISR del driver è in esecuzione in IRQL = PASSIVE_LEVEL, WdfInterruptQueueWorkItemForIsr restituisce TRUE se accoda correttamente la funzione di callback dell'oggetto interrupt EvtInterruptWorkItem . Il metodo restituisce FALSE se la funzione di callback è stata in precedenza accodata e non è stata eseguita.

Se l'ISR del driver è in esecuzione in IRQL = DIRQL, il framework esegue prima una coda DPC interna e quindi accoda un elemento di lavoro da tale DPC. In questo caso, WdfInterruptQueueWorkItemForIsr restituisce TRUE se il framework accoda correttamente il DPC interno. Il metodo restituisce FALSE se il DPC interno è stato accodato in precedenza.

Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.

Commenti

I driver in genere chiamano WdfInterruptQueueWorkItemForIsr dall'interno di una funzione di callback EvtInterruptIsr .

La funzione di callback evtInterruptWorkItem di un oggetto di interruzione può essere accodata una sola volta prima dell'esecuzione. Pertanto, se una chiamata a WdfInterruptQueueWorkItemForIsr ha esito positivo, le chiamate successive non accoderanno callback aggiuntivi.

Per altre informazioni sulla gestione degli interruzioni nei driver basati su framework, vedere Gestione degli interruzioni hardware.

Si verifica un controllo di bug se i driver chiamano WdfInterruptQueueWorkItemForIsr con un oggetto interrupt che non specifica una funzione di callback EvtInterruptWorkItem .

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.11
Versione UMDF minima 2,0
Intestazione wdfinterrupt.h (include Wdf.h)
Libreria Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DIRQL
Regole di conformità DDI DriverCreate(kmdf)

Vedi anche

EvtInterruptDpc

EvtInterruptIsr

WdfInterruptCreate

WdfInterruptQueueDpcForIsr