Funzione WdfDpcEnqueue (wdfdpc.h)
[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) |