Share via

IDirect3DDevice8::GetInfo

  • Article

This method retrieves information about the rendering device.

HRESULT GetInfo(
  DWORD DevInfoID,
  VOID* pDevInfoStruct,
  DWORD DevInfoStructSize
);

Parameters

  • DevInfoID
    [in] Value used to identify what information will be returned in pDevInfoStruct.
  • pDevInfoStruct
    [in, out] Pointer to a structure that receives the specified device information if the call succeeds.
  • DevInfoStructSize
    [in] 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 Microsoft® DirectX® (see Remarks).

If the method fails, the return value can be D3DERR_INVALIDCALL.

Remarks

Information returned by this method 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.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: D3d8.h.
Link Library: D3d8.lib.

See Also

IDirect3DDevice8::BeginScene | IDirect3DDevice8::EndScene | IDirect3DDevice8

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.