Funzione WdfDpcCancel (wdfdpc.h)

Articolo
08/08/2023

[Si applica solo a KMDF]

Il metodo WdfDpcCancel tenta di annullare l'esecuzione della funzione di callback evtDpcFunc pianificata di un oggetto DPC.

Sintassi

BOOLEAN WdfDpcCancel(
  [in] WDFDPC  Dpc,
  [in] BOOLEAN Wait
);

Parametri

[in] Dpc

Handle per un oggetto DPC del framework.

[in] Wait

Valore booleano che, se TRUE, indica che il metodo WdfDpcCancel non verrà restituito finché la funzione di callback EvtDpcFunc dell'oggetto DPC non viene annullata o terminata l'esecuzione. Se FALSE, il metodo WdfDpcCancel restituisce immediatamente.

Valore restituito

WdfDpcCancel restituisce TRUE se la funzione di callback EvtDpcFunc dell'oggetto DPC specificato si trovava nella coda DPC del sistema. Il metodo restituisce FALSE se la funzione di callback non era presente nella coda DPC, perché la funzione di callback era in esecuzione o perché era stata completata l'esecuzione.

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

Commenti

Se la funzione di callback EvtDpcFunc dell'oggetto DPC specificato si trova nella coda DPC del sistema, viene rimossa dalla coda. Se la funzione EvtDpcFunc non si trova nella coda, è in esecuzione o è stata completata l'esecuzione.

Se il parametro Wait è TRUE, WdfDpcCancel deve essere chiamato in IRQL = PASSIVE_LEVEL. Se il parametro Wait è FALSE, WdfDpcCancel può essere chiamato in qualsiasi IRQL.

Esempio

Nell'esempio di codice seguente viene annullata l'esecuzione della funzione di callback associata all'oggetto DPC creato dall'esempio di codice nell'argomento WdfDpcCreate .

WdfDpcCancel(
             PDevExt->CompleteWriteDpc,
             TRUE
             );

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Intestazione	wdfdpc.h (include Wdf.h)
Libreria	Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL	Vedere la sezione Osservazioni.
Regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

EvtDpcFunc

Condividi tramite