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