Microsoft DirectX 8.0 (C++) |
Retrieves information about the rendering device.
HRESULT GetInfo( DWORD DevInfoID, VOID* pDevInfoStruct, DWORD DevInfoStructSize );
If the method succeeds, the return value is D3D_OK. This method returns S_FALSE on retail builds of Microsoft® DirectX® (see Remarks).
If the method fails, the return value can be D3DERR_INVALIDCALL.
Information returned by this method can pertains to the underlying device driver. 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 an application's performance when it executes slowly. Do not call this method during scene rendering (between calls to IDirect3DDevice8::BeginScene and IDirect3DDevice8::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.
Header: Declared in D3d8.h.
Import Library: Use D3d8.lib.