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

Vedi anche

CustomDpc

CustomThreadedDpc

KeInitializeDpc

KeRemoveQueueDpc