The D3DKMTCreateDCFromMemory function creates a display context from a specified block of memory.
NTSTATUS D3DKMTCreateDCFromMemory( D3DKMT_CREATEDCFROMMEMORY *Arg1 );
pData [in, out]
A pointer to a D3DKMT_CREATEDCFROMMEMORY structure that describes parameters for creating a display context.
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.
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.
|Minimum supported client||Available in Windows Vista and later versions of the Windows operating systems.|
|Header||d3dkmthk.h (include D3dkmthk.h)|