D3DENUMDEVICESCALLBACK

D3DENUMDEVICESCALLBACK is the prototype definition for the callback function to enumerate installed Direct3D devices.

typedef HRESULT (FAR PASCAL * LPD3DENUMDEVICESCALLBACK)
  (LPGUID lpGuid,                     
  LPSTR lpDeviceDescription,          
  LPSTR lpDeviceName,                 
  LPD3DDEVICEDESC lpD3DHWDeviceDesc,  
  LPD3DDEVICEDESC lpD3DHELDeviceDesc,  
  LPVOID lpUserArg                    
);
 

Parameters

lpGuid

Address of a globally unique identifier (GUID).

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.

lpUserArg

Address of application-defined data passed to this callback function.

Return Values

Applications should return one of the following values:

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.

QuickInfo

  Windows NT: Use version 4.0 or later.
  Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in d3dcaps.h.
  Import Library: User-defined.