Funzione WdfDpcEnqueue (wdfdpc.h)

  • Articolo

[Si applica solo a KMDF]

Il metodo WdfDpcEnqueue pianifica l'esecuzione di una funzione di callback evtDpcFunc di un oggetto DPC.

Sintassi

BOOLEAN WdfDpcEnqueue(
  [in] WDFDPC Dpc
);

Parametri

[in] Dpc

Handle per un oggetto DPC del framework.

Valore restituito

WdfDpcEnqueue restituisce TRUE se aggiunge correttamente l'oggetto DPC specificato alla coda DPC del sistema. In caso contrario, il metodo restituisce FALSE.

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

Commenti

Il metodo WdfDpcEnqueue aggiunge l'oggetto DPC specificato alla coda DPC del sistema, se non è già presente nella coda. Se l'oggetto DPC era già presente nella coda, il metodo restituisce FALSE. Quando il sistema non esegue attività con priorità superiore, rimuove l'oggetto DPC dalla coda e chiama la funzione di callback EvtDpcFunc dell'oggetto.

Dopo l'esecuzione della funzione di callback, una chiamata successiva a WdfDpcEnqueue aggiungerà nuovamente l'oggetto DPC alla coda DPC.

Per altre informazioni sull'uso di oggetti DPC, vedere Manutenzione di un interruzione.

Esempio

Nell'esempio di codice seguente viene pianificata l'esecuzione della funzione callback associata a un oggetto DPC. Nell'esempio viene usato il valore restituito del metodo WdfDpcEnqueue come valore restituito della funzione contenente. L'esempio di codice WdfDpcCreate mostra come è stato creato l'oggetto DPC.

return WdfDpcEnqueue(PDevExt->CompleteWriteDpc);

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1,0
Intestazione wdfdpc.h (includere Wdf.h)
Libreria Wdf01000.sys (vedere Framework Library Versioning).
IRQL Qualsiasi livello
Regole di conformità DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

EvtDpcFunc

WdfDpcCreate