Funzione WdfDpcWdmGetDpc (wdfdpc.h)

Articolo
02/27/2024

[Si applica solo a KMDF]

Il metodo WdfDpcWdmGetDpc restituisce un puntatore alla struttura KDPC associata a un oggetto DPC del framework specificato.

Sintassi

PKDPC WdfDpcWdmGetDpc(
  [in] WDFDPC Dpc
);

Parametri

[in] Dpc

Handle per un oggetto DPC del framework.

Valore restituito

WdfDpcWdmGetDpc restituisce un puntatore alla struttura KDPC associata all'oggetto DPC del framework specificato.

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

Commenti

Il framework crea una struttura KDPC quando un driver basato su framework chiama WdfDpcCreate per creare un oggetto DPC.

Un driver potrebbe chiamare WdfDpcWdmGetDpc dall'interno della sua funzione di callback EvtDpcFunc .

Il puntatore restituito da WdfDpcWdmGetDpc è valido finché l'oggetto DPC del framework non viene eliminato. Se il driver fornisce una funzione EvtCleanupCallback per l'oggetto DPC framework, il puntatore è valido fino a quando la funzione di callback non viene restituita.

Esempio

L'esempio di codice seguente restituisce un puntatore alla struttura KDPC associata a un oggetto DPC specificato. L'esempio di codice WdfDpcCreate mostra come è stato creato l'oggetto DPC specificato.

PKDPC pWdmDpc;

pWdmDpc = WdfDpcWdmGetDpc(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