IDirect3DDevice7::GetInfo

The IDirect3DDevice7::GetInfo method retrieves information about the rendering device. Information can pertain to Direct3D or the underlying device driver.

HRESULT GetInfo( 
  DWORD  dwDevInfoID, 
  LPVOID pDevInfoStruct, 
  DWORD  dwSize
); 

Parameters

dwDevInfoID

Flags indicating the type of device information structure at pDevInfoStruct. This parameter can be set to one of the following flags:

D3DDEVINFOID_TEXTUREMANAGER

The structure at pDevInfoStruct is a D3DDEVINFO_TEXTUREMANAGER structure that contains information about the texture management being performed by the driver. If the driver does not manage textures, information about texture management performed by Direct3D is retrieved.

D3DDEVINFOID_D3DTEXTUREMANAGER

The structure at pDevInfoStruct is a D3DDEVINFO_TEXTUREMANAGER structure that contains information about texture management that is performed by Direct3D.

D3DDEVINFOID_TEXTURING

The structure at pDevInfoStruct is a D3DDEVINFO_TEXTURING structure that contains information about texturing activity of the application.

pDevInfoStruct

Address of a structure that receives the specified device information if the call succeeds. The type of structure, and how the data it contains is to be interpreted, is determined by the flag in dwDevInfoID.

dwSize

Size of the structure at pDevInfoStruct, in bytes.

Return Values

If the method succeeds, the return value is D3D_OK. This method returns S_FALSE on retail builds of DirectX.

If the method fails, the return value can be one of the following error values:

Remarks

This method makes it possible for drivers to declare specific information types, and corresponding structures, that are not documented in this SDK.

This method executes synchronously and can negatively impact your application's performance when it executes slowly. Do not call this method during scene rendering (between calls to IDirect3DDevice7::BeginScene and IDirect3DDevice7::EndScene).

This method is intended to be used for performance tracking and debugging during product development (on the debug version of DirectX). The method can succeed, returning S_FALSE, without retrieving device data. This occurs when the retail version of the DirectX runtime is installed on the host system.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Version: Requires DirectX 7.0.
  Header: Declared in d3d.h.

See Also

D3DDEVINFO_TEXTUREMANAGER