KeInitializeDpc function (wdm.h)

Article
02/22/2024

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

Syntax

void KeInitializeDpc(
  [out]          __drv_aliasesMem PRKDPC Dpc,
  [in]           PKDEFERRED_ROUTINE      DeferredRoutine,
  [in, optional] __drv_aliasesMem PVOID  DeferredContext
);

Parameters

[out] Dpc

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

[in] DeferredRoutine

Pointer to the CustomDpc routine to associate with the DPC.

[in, optional] 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

Requirement	Value
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