D3DEnumDevicesCallback

The D3DEnumDevicesCallback is an application-defined callback function for the IDirect3D3::EnumDevices method.

HRESULT CALLBACK D3DEnumDevicesCallback(
  GUID FAR* lpGuid,                    
  LPSTR lpDeviceDescription,           
  LPSTR lpDeviceName,                  
  LPD3DDEVICEDESC lpD3DHWDeviceDesc,   
  LPD3DDEVICEDESC lpD3DHELDeviceDesc,  
  LPVOID lpContext                     
);
 

Parameters

lpGuid

Address of a globally unique identifier (GUID) that identifies a Direct3D device.

lpDeviceDescription

Address of a textual description of the device.

lpDeviceName

Address of the device name.

lpD3DHWDeviceDesc

Address of a D3DDEVICEDESC structure that contains the hardware capabilities of the Direct3D device.

lpD3DHELDeviceDesc

Address of a D3DDEVICEDESC structure that contains the emulated 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

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 LPD3DENUMDEVICESCALLBACK data type is defined as a pointer to this callback function:

typedef HRESULT (FAR PASCAL * LPD3DENUMDEVICESCALLBACK)(
  GUID FAR *lpGuid, LPSTR lpDeviceDescription, LPSTR lpDeviceName, 
  LPD3DDEVICEDESC, LPD3DDEVICEDESC, LPVOID);
 

QuickInfo

  Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in d3dcaps.h.
  Import Library: User-defined.