PFND3DDDI_GETINFO callback function (d3dumddi.h)

Article
02/22/2024

The GetInfo function retrieves information about the specified display device.

Syntax

PFND3DDDI_GETINFO Pfnd3dddiGetinfo;

HRESULT Pfnd3dddiGetinfo(
  HANDLE hDevice,
  UINT unnamedParam2,
  VOID *unnamedParam3,
  UINT DevInfoSize
)
{...}

Parameters

hDevice

A handle to the display device (graphics context).

unnamedParam2

DevInfoID

An identifier for the type of device information to retrieve.

unnamedParam3

pDevInfoStruct

A pointer to a buffer of the type that DevInfoID specifies that receives information about the device.

DevInfoSize

The size, in bytes, of the buffer that is supplied by pDevInfoStruct.

Return value

GetInfo returns one of the following values:

Return code	Description
S_OK	The device information is successfully retrieved.
E_NOTIMPL	The driver does not support the requested type of device information.
E_INVALIDARG	Parameters were validated and determined to be incorrect.

Remarks

The Microsoft DirectX 7 and DirectX 8 runtimes call the GetInfo function to query a user-mode display driver for additional device information.

The Direct3D 8 runtime sets the D3DDDIDEVINFOID_VCACHE flag in the DevInfoID parameter and specifies an empty D3DDDIDEVINFO_VCACHE structure in the pDevInfoStruct parameter to query the user-mode display driver's support for vertex cache.

Requirements

Requirement	Value
Minimum supported client	Available in Windows Vista and later versions of the Windows operating systems.
Target Platform	Desktop
Header	d3dumddi.h (include D3dumddi.h)