Platform SDK: DirectX

D3DEnumDevicesCallback7

The D3DEnumDevicesCallback7 is an application-defined callback function for the IDirect3D7::EnumDevices method.

HRESULT CALLBACK D3DEnumDevicesCallback7(
  LPSTR lpDeviceDescription, 
  LPSTR lpDeviceName, 
  LPD3DDEVICEDESC7 lpD3DDeviceDesc,
  LPVOID lpContext
);

Parameters

lpDeviceDescription
Address of a textual description of the device.
lpDeviceName
Address of the device name.
lpD3DDeviceDesc
Address of a D3DDEVICEDESC7 structure that contains the hardware capabilities of the Direct3D device.
lpContext
Address of application-defined data passed to this callback function.

Return Values

Applications should return D3DENUMRET_OK to continue the enumeration, or D3DENUMRET_CANCEL to cancel it.

Remarks

This callback function supersedes the D3DEnumDevicesCallback callback for all interfaces later than IDirect3D3.

When determining the order in which to call callback functions, the system searches the objects highest in the hierarchy first, and then calls their callback functions in the order in which they were created.

The LPD3DENUMDEVICESCALLBACK7 data type is defined as a pointer to this callback function:

typedef HRESULT (CALLBACK * LPD3DENUMDEVICESCALLBACK7)(
  LPSTR lpDeviceDescription, LPSTR lpDeviceName, 
  LPD3DDEVICEDESC7, LPVOID);

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 98.
  Version: Requires DirectX 7.0.
  Header: Declared in d3dcaps.h.