Direct3DDevice7.GetInfo

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

object.GetInfo( _
    lDevInfoID As CONST_D3DDEVINFOID, _ 
    DevInfoType As Any, _ 
    lSize As Long)

Parameters

object

Object expression that resolves to a Direct3DDevice7 object.

lDevInfoID

Flag from the CONST_D3DDEVINFOID enumeration that indicate the data type of the DevInfoType parameter.

DevInfoType

Variable that will contain the specified device information if the call succeeds. The data type of this variable, and how the data it contains is to be interpreted, is determined by the flag in lDevInfoID.

lSize

Size of the type at DevInfoType, in bytes, as returned by the Len Visual Basic function.

Return Values

None.

Error Codes

If the method fails, the return value may be S_FALSE to indicate that the device does not support information queries, or one of the following error codes:

Remarks

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

This method executes synchronously, and it can negatively impact your application's performance when it executes slowly. Do not call this method during scene rendering (between calls to Direct3DDevice7.BeginScene and Direct3DDevice7.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 without retrieving device data. This occurs when the retail version of the DirectX runtime is installed on the host system.

See Also

D3DDEVINFO_TEXTUREMANAGER