D3DFINDDEVICESEARCH

The D3DFINDDEVICESEARCH structure specifies the characteristics of a device an application wants to find. This structure is used in calls to the IDirect3D3::FindDevice method.

typedef struct _D3DFINDDEVICESEARCH { 
    DWORD         dwSize; 
    DWORD         dwFlags; 
    BOOL          bHardware; 
    D3DCOLORMODEL dcmColorModel; 
    GUID          guid; 
    DWORD         dwCaps; 
    D3DPRIMCAPS   dpcPrimCaps; 
} D3DFINDDEVICESEARCH, *LPD3DFINDDEVICESEARCH; 
 

Members

dwSize

Size, in bytes, of this structure. This member must be initialized before the structure is used.

dwFlags

Flags defining the type of device the application wants to find. This member can be one or more of the following values:

D3DFDS_ALPHACMPCAPS

Match the dwAlphaCmpCaps member of the D3DPRIMCAPS structure specified as the dpcPrimCaps member of this structure.

D3DFDS_COLORMODEL

Match the color model specified in the dcmColorModel member of this structure.

D3DFDS_DSTBLENDCAPS

Match the dwDestBlendCaps member of the D3DPRIMCAPS structure specified as the dpcPrimCaps member of this structure.

D3DFDS_GUID

Match the globally unique identifier (GUID) specified in the guid member of this structure.

D3DFDS_HARDWARE

Match the hardware or software search specification given in the bHardware member of this structure.

D3DFDS_LINES

Match the D3DPRIMCAPS structure specified by the dpcLineCaps member of the D3DDEVICEDESC structure.

D3DFDS_MISCCAPS

Match the dwMiscCaps member of the D3DPRIMCAPS structure specified as the dpcPrimCaps member of this structure.

D3DFDS_RASTERCAPS

Match the dwRasterCaps member of the D3DPRIMCAPS structure specified as the dpcPrimCaps member of this structure.

D3DFDS_SHADECAPS

Match the dwShadeCaps member of the D3DPRIMCAPS structure specified as the dpcPrimCaps member of this structure.

D3DFDS_SRCBLENDCAPS

Match the dwSrcBlendCaps member of the D3DPRIMCAPS structure specified as the dpcPrimCaps member of this structure.

D3DFDS_TEXTUREBLENDCAPS

Match the dwTextureBlendCaps member of the D3DPRIMCAPS structure specified as the dpcPrimCaps member of this structure.

D3DFDS_TEXTURECAPS

Match the dwTextureCaps member of the D3DPRIMCAPS structure specified as the dpcPrimCaps member of this structure.

D3DFDS_TEXTUREFILTERCAPS

Match the dwTextureFilterCaps member of the D3DPRIMCAPS structure specified as the dpcPrimCaps member of this structure.

D3DFDS_TRIANGLES

Match the D3DPRIMCAPS structure specified by the dpcTriCaps member of the D3DDEVICEDESC structure.

D3DFDS_ZCMPCAPS

Match the dwZCmpCaps member of the D3DPRIMCAPS structure specified as the dpcPrimCaps member of this structure.

bHardware

Flag specifying whether the device to find is implemented as hardware or software. If this member is TRUE, the device to search for has hardware rasterization and may also provide other hardware acceleration. Applications that use this flag should set the D3DFDS_HARDWARE bit in the dwFlags member.

dcmColorModel

One of the values of the D3DCOLORMODEL data type, specifying whether the device to find should use the ramp or RGB color model.

guid

Globally unique identifier (GUID) of the device to find.

dwCaps

Reserved.

dpcPrimCaps

Specifies a D3DPRIMCAPS structure defining the device's capabilities for each primitive type.

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.

See Also

D3DFINDDEVICERESULT