D3DFINDDEVICESEARCH

The D3DFINDDEVICESEARCH structure specifies the characteristics of a device an application wants to find. This structure is used in calls to the IDirect3D2::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 members of the D3DCOLORMODEL enumerated 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: 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.

See Also

D3DFINDDEVICERESULT