PFND3DKMT_CREATEDCFROMMEMORY callback function (d3dkmthk.h)

The D3DKMTCreateDCFromMemory function creates a display context from a specified block of memory.

Syntax

PFND3DKMT_CREATEDCFROMMEMORY Pfnd3dkmtCreatedcfrommemory;

NTSTATUS Pfnd3dkmtCreatedcfrommemory(
  D3DKMT_CREATEDCFROMMEMORY *unnamedParam1
)
{...}

Parameters

unnamedParam1

pData [in, out]

A pointer to a D3DKMT_CREATEDCFROMMEMORY structure that describes parameters for creating a display context.

Return value

D3DKMTCreateDCFromMemory returns one of the following values:

Return code Description
STATUS_SUCCESS The display context was successfully created.
STATUS_INVALID_PARAMETER Parameters were validated and determined to be incorrect.

This function might also return other NTSTATUS values.

Remarks

The kernel controls the memory referenced by the display context created by the D3DKMTCreateDCFromMemory function. You must call the D3DKMTDestoryDCFromMemory function to free the memory referenced by the display context. Any other approach to free this memory will fail.

During the execution of the D3DKMTCreateDCFromMemory function, the kernel locks and probes the referenced memory by performing a non-thread safe write to each page in the memory. No other threads in your process should be trying to access any part of this memory for the duration of the D3DKMTCreateDCFromMemory call; otherwise, the results will be undefined.

Requirements

Requirement Value
Minimum supported client Windows Vista
Target Platform Universal
Header d3dkmthk.h (include D3dkmthk.h)

See also

D3DKMT_CREATEDCFROMMEMORY