Direct3DDevice8.GetInfo

Retrieves information about the rendering device.

object.GetInfo( _ 
    DevInfoID As Long, _ 
    Info As Any, _ 
    Size As Long)

Parts

object

Object expression that resolves to a Direct3DDevice8 object.

DevInfoID

Value used to identify what information will be returned in Info.

Info

A type that receives the specified device information if the call succeeds.

Size

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

Error Codes

If this method fails, an error is raised and Err.Number is set to one of the following values.

D3DERR_INVALIDCALL	One or more parameters are invalid.
E_FAIL	All parameters are valid, but not supported. The type passed in the Info parameter is not filled.
S_FALSE	All parameters are valid, but an unknown error occurred. The type passed in the Info parameter is not filled.

For information on trapping errors, see the Visual Basic Error Handling topic.

Remarks

Information returned by this method can pertain to Microsoft® Direct3D® or 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 software development kit (SDK).

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

This method is intended to be used for performance tracking and debugging during product development.

The following table shows a list of all the possible input values and the expected return value. ID is equivalent to the DevInfoID parameter, Type is equivalent to the Info parameter, and Size is equivalent to the Size parameter.

ID	Type	Size	Expected return value
-	NULL	-	D3DERR_INVALIDCALL
-	-	0	D3DERR_INVALIDCALL
0	Type_5	Size_5	E_FAIL
ID_1	Type_1	Size_1	E_FAIL
ID_2	Type_2	Size_2	E_FAIL
ID_3	Type_3	Size_3	E_FAIL
ID_4	Type_4	Size_4	S_FALSE
ID_5	Type_5	Size_5	E_FAIL