Funzione KeInsertQueueDpc (wdm.h)
La routine KeInsertQueueDpc accoda un DPC per l'esecuzione.
Sintassi
BOOLEAN KeInsertQueueDpc(
[in, out] PRKDPC Dpc,
[in, optional] PVOID SystemArgument1,
[in, optional] __drv_aliasesMem PVOID SystemArgument2
);
Parametri
[in, out] Dpc
Puntatore alla struttura KDPC per l'oggetto DPC. Questa struttura deve essere stata inizializzata da KeInitializeDpc o KeInitializeThreadedDpc.
[in, optional] SystemArgument1
Specifica i dati di contesto determinati dal driver. Questo valore viene passato come parametro SystemArgument1 alla routine CustomDpc o CustomThreadedDpc dell'oggetto DPC.
[in, optional] SystemArgument2
Specifica i dati di contesto determinati dal driver. Questo valore viene passato come parametro SystemArgument2 alla routine CustomDpc o CustomThreadedDpc dell'oggetto DPC.
Valore restituito
Se l'oggetto DPC specificato non si trova attualmente in una coda DPC, KeInsertQueueDpc accoda il DPC e restituisce TRUE.
Commenti
Se l'oggetto DPC specificato è già stato accodato, non viene eseguita alcuna operazione tranne per restituire FALSE. In caso contrario, l'oggetto DPC viene inserito in una coda DPC. Per altre informazioni sulle code DPC, vedere Organizzazione delle code DPC.
Si noti che un particolare oggetto DPC e la funzione che rappresenta possono essere accodati per l'esecuzione una sola volta in un determinato momento.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 2000. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Qualsiasi livello |
| Regole di conformità DDI | HwStorPortProhibitedDDIs(storport), MarkingQueuedIrps(wdm) |