Funzione WdfDpcEnqueue (wdfdpc.h)

[Si applica solo a KMDF]

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

Sintassi

BOOLEAN WdfDpcEnqueue(
  [in] WDFDPC Dpc
);

Parametri

[in] Dpc

Handle per un oggetto DPC 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.

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Osservazioni:

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à più alta, rimuove l'oggetto DPC dalla coda e chiama il evtDpcFunc dell'oggetto funzione di callback.

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 uninterrupt.

Esempi

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

return WdfDpcEnqueue(PDevExt->CompleteWriteDpc);

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
versione minima di KMDF	1.0
intestazione	wdfdpc.h (include Wdf.h)
Biblioteca	Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL	Qualsiasi livello
regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedere anche

EvtDpcFunc

WdfDpcCreare