Platform SDK: DirectX |
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 );
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:
DDERR_INVALIDOBJECT |
DDERR_INVALIDPARAMS |
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.
Windows NT/2000: Requires Windows 2000.
Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
Version: Requires DirectX 7.0.
Header: Declared in d3d.h.