KeInitializeDpc function

The KeInitializeDpc routine initializes a DPC object, and registers a CustomDpc routine for that object.

Syntax

NTKERNELAPI VOID KeInitializeDpc(
  __drv_aliasesMem PRKDPC Dpc,
  PKDEFERRED_ROUTINE      DeferredRoutine,
  __drv_aliasesMem PVOID  DeferredContext
);

Parameters

Dpc

Pointer to a KDPC structure that represents the DPC object to initialize. The caller must allocate storage for the structure from resident memory.

DeferredRoutine

Pointer to the CustomDpc routine to associate with the DPC.

DeferredContext

Specifies the value to pass as the DeferredContext parameter to CustomDpc.

Return Value

None

Remarks

The caller can queue an initialized DPC with KeInsertQueueDpc. The caller also can set up a timer object associated with the initialized DPC object and queue the DPC with KeSetTimer.

Storage for the DPC object must be resident: in the device extension of a driver-created device object, in the controller extension of a driver-created controller object, or in nonpaged pool allocated by the caller.

Requirements

   
Minimum supported client Available starting with Windows 2000.
Target Platform Universal
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Any level

See Also

CustomDpc

KeInsertQueueDpc

KeRemoveQueueDpc

KeSetTimer