D3DX10CreateDevice function
Create the best Direct3D 10 device that represents the display adapter. If a Direct3D 10.1-compatible device can be created, it will be possible to acquire an ID3D10Device1 Interface pointer from the returned device interface pointer.
Syntax
HRESULT D3DX10CreateDevice(
_In_ IDXGIAdapter *pAdapter,
_In_ D3D10_DRIVER_TYPE DriverType,
_In_ HMODULE Software,
_In_ UINT Flags,
_Out_ ID3D10Device **ppDevice
);
Parameters
-
pAdapter [in]
-
Type: IDXGIAdapter*
Pointer to the display adapter (see the IDXGIAdapter interface) 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 the IDXGIFactory interface.
-
DriverType [in]
-
Type: D3D10_DRIVER_TYPE
The device-driver type (see the D3D10_DRIVER_TYPE enumeration). The driver type determines the type of device you will create.
-
Software [in]
-
Type: HMODULE
A handle to a loaded module that implements a software driver (such as D3D10Ref.dll). To get a handle, call the GetModuleHandle function.
-
Flags [in]
-
Type: UINT
Device creation flags (see the D3D10_CREATE_DEVICE_FLAG enumeration) that enable API layers. These flags can be bitwise OR'd together.
-
ppDevice [out]
-
Type: ID3D10Device**
Address of a pointer to the device created (see the ID3D10Device interface).
Return value
Type: HRESULT
This function returns one of the following Direct3D 10 Return Codes.
Remarks
This function attempts to create the best device for the hardware. First, the function attempts to create a 10.1 device. If a 10.1 device cannot be created, the function attempts to create a 10.0 device. If neither device is successfully created, the function returns E_FAIL.
If your application needs to create only a 10.1 device, or a 10.0 device only, use the following functions instead:
- Use the D3D10CreateDevice function to create a Direct3D 10.0 device only.
- Use the D3D10CreateDevice1 function to create a Direct3D 10.1 device only.
- Use the D3DX10GetFeatureLevel1 function to get an ID3D10Device1 interface pointer from an ID3D10Device interface pointer.
A Direct3D 10.1 device can only be created on computers running Windows Vista Service Pack 1 or later, and with Direct3D 10.1-compatible hardware installed. However, it is legal to call this function on computers running any version of Windows that has the D3DX10 DLL installed.
Requirements
| Requirement | Value |
|---|---|
| Header |
|
See also