D3D10CreateDevice1 function (d3d10_1.h)
Create a Direct3D 10.1 device that represents the display adapter.
Syntax
HRESULT D3D10CreateDevice1(
[in] IDXGIAdapter *pAdapter,
[in] D3D10_DRIVER_TYPE DriverType,
[in] HMODULE Software,
[in] UINT Flags,
[in] D3D10_FEATURE_LEVEL1 HardwareLevel,
[in] UINT SDKVersion,
[out] ID3D10Device1 **ppDevice
);
Parameters
[in] pAdapter
Type: IDXGIAdapter*
Pointer to the display adapter (see IDXGIAdapter) when creating a hardware device; otherwise set this parameter to NULL. If NULL is specified when creating a hardware device, Direct3D will use the first adapter enumerated by EnumAdapters.
[in] DriverType
Type: D3D10_DRIVER_TYPE
The device-driver type (see D3D10_DRIVER_TYPE). The driver type determines the type of device you will create.
[in] Software
Type: HMODULE
This is set to NULL except for D3D10_DRIVER_TYPE_SOFTWARE driver types.
[in] Flags
Type: UINT
Optional. Device creation flags (see D3D10_CREATE_DEVICE_FLAG) that enable API layers. These flags can be bitwise OR'd together.
[in] HardwareLevel
Type: D3D10_FEATURE_LEVEL1
The version of hardware that is available for acceleration (see D3D10_FEATURE_LEVEL1).
[in] SDKVersion
Type: UINT
Bit flag that indicates the version of the SDK. Should be D3D10_1_SDK_VERSION, defined in D3D10.h.
[out] ppDevice
Type: ID3D10Device1**
Address of a pointer to the device created (see ID3D10Device1 Interface).
Return value
Type: HRESULT
This method returns one of the following Direct3D 10 Return Codes.
Remarks
To create a device and a swap chain at the same time, see D3D10CreateDeviceAndSwapChain1.
This method requires Windows Vista Service Pack 1, Windows Server 2008, or later release of Windows.
The object returned by D3D10CreateDevice1 implements the IUnknown interface and can be queried for other interfaces the object supports. To retrieve the IDXGIDevice interface of the object the following code could be used.
IDXGIDevice * pDXGIDevice;
hr = g_pd3dDevice->QueryInterface(__uuidof(IDXGIDevice), (void **)&pDXGIDevice);
Requirements
Requirement | Value |
---|---|
Target Platform | Windows |
Header | d3d10_1.h |
Library | D3D10_1.lib |
DLL | D3D10_1.dll |