Expand Minimize

D3DKMTCreateDevice function

The D3DKMTCreateDevice function creates a kernel-mode device context.

Syntax


NTSTATUS D3DKMTCreateDevice(
  _Inout_  D3DKMT_CREATEDEVICE *pData
);

Parameters

pData [in, out]

A pointer to a D3DKMT_CREATEDEVICE structure that describes the kernel-mode device context.

Return value

D3DKMTCreateDevice returns one of the following values:

Return codeDescription
STATUS_SUCCESS

The device context was successfully created.

STATUS_DEVICE_REMOVED

The graphics adapter was stopped.

STATUS_INVALID_PARAMETER

Parameters were validated and determined to be incorrect.

STATUS_NO_MEMORY

D3DKMTCreateDevice could not complete because of insufficient memory.

 

This function might also return other NTSTATUS values.

Examples

The following code example demonstrates how an OpenGL ICD can use D3DKMTCreateDevice to create a kernel-mode device context.


HRESULT CreateDevice(HANDLE hAdapter, VOID** pCommandBuffer, UINT* pCommandBufferSize)
{
    D3DKMT_CREATEDEVICE CreateDevice;

    memset(&CreateDevice, 0, sizeof(CreateDevice));
    CreateDevice.hAdapter = hAdapter;

    if (NT_SUCCESS((*pfnKTCreateDevice)(&CreateDevice))) {
        *pCommandBuffer = CreateDevice.pCommandBuffer;
        *pCommandBufferSize = CreateDevice.CommandBufferSize'
        return S_OK;
    }
    return E_FAIL;
}

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_CREATEDEVICE

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft