D3DX10GetFeatureLevel1 function

Article
03/15/2021

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