Funzione KeInsertQueueDpc (wdm.h)

Articolo
02/27/2024

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)

Vedi anche