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:
| D3DENUMRET_CANCEL | ||
| Cancel the enumeration. | ||
| D3DENUMRET_OK | ||
| Continue the enumeration. | ||
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.