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