Expand Minimize

D3DKMTCreateDCFromMemory function

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

Syntax


NTSTATUS D3DKMTCreateDCFromMemory(
  _Inout_  D3DKMT_CREATEDCFROMMEMORY *pData
);

Parameters

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 codeDescription
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

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

D3dkmthk.h (include D3dkmthk.h)

Library

Gdi32.lib

See also

D3DKMT_CREATEDCFROMMEMORY

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft