D3DX10GetFeatureLevel1 function

Get a Direct3D 10.1 device interface pointer from a Direct3D 10.0 interface pointer.

Syntax

HRESULT D3DX10GetFeatureLevel1(
  _In_  ID3D10Device  *pDevice,
  _Out_ ID3D10Device1 **ppDevice
);

Parameters

pDevice [in]

Type: ID3D10Device*

Pointer to the Direct3D 10.0 device (see the ID3D10Device interface).

ppDevice [out]

Type: ID3D10Device1**

Pointer to the Direct3D 10.1 device (see the ID3D10Device1 interface).

Return value

Type: HRESULT

This function returns one of the following Direct3D 10 Return Codes. If a Direct3D 10.1 device interface can be acquired, this function succeeds and passes a pointer to the 10.1 interface using the ppDevice parameter. If a Direct3D 10.1 device interface cannot be acquired, this function returns E_FAIL, and will not return anything for the ppDevice parameter.

Remarks

For this function to succeed, you must have acquired the supplied ID3D10Device pointer using a call to the D3DX10CreateDevice function, the D3DX10CreateDeviceAndSwapChain function, the D3D10CreateDevice1 function, or the D3D10CreateDeviceAndSwapChain1 function.

You can only create a Direct3D 10.1 device on computers running Windows Vista Service Pack 1 or later, and with Direct3D 10.1-compatible hardware installed. This function will return E_FAIL on any computer not meeting these requirements. However, you can call this function on any version of Windows that has the D3DX10 DLL installed.

Requirements

Requirement Value
Header
D3DX10Core.h

See also

General Purpose Functions