Skip to content

Latest commit

 

History

History
110 lines (84 loc) · 4.52 KB

nf-d3d9helper-idirect3d9-enumadaptermodes.md

File metadata and controls

110 lines (84 loc) · 4.52 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:d3d9helper.IDirect3D9.EnumAdapterModes
IDirect3D9::EnumAdapterModes (d3d9helper.h)
The IDirect3D9::EnumAdapterModes (d3d9helper.h) method queries the device to determine whether the specified adapter supports the requested format and display mode.
EnumAdapterModes
EnumAdapterModes method [Direct3D 9]
EnumAdapterModes method [Direct3D 9]
IDirect3D9 interface
IDirect3D9 interface [Direct3D 9]
EnumAdapterModes method
IDirect3D9.EnumAdapterModes
IDirect3D9::EnumAdapterModes
d3d9helper/IDirect3D9::EnumAdapterModes
dfe3f630-cfbd-1855-e8f0-abdadb49cfae
direct3d9.idirect3d9__enumadaptermodes
direct3d9\idirect3d9__enumadaptermodes.htm
direct3d9
VS|directx_sdk|~\idirect3d9__enumadaptermodes.htm
08/11/2022
EnumAdapterModes, EnumAdapterModes method [Direct3D 9], EnumAdapterModes method [Direct3D 9],IDirect3D9 interface, IDirect3D9 interface [Direct3D 9],EnumAdapterModes method, IDirect3D9.EnumAdapterModes, IDirect3D9::EnumAdapterModes, d3d9helper/IDirect3D9::EnumAdapterModes, dfe3f630-cfbd-1855-e8f0-abdadb49cfae, direct3d9.idirect3d9__enumadaptermodes
d3d9helper.h
D3D9.h
Windows
D3D9.lib
Windows
19H1
IDirect3D9::EnumAdapterModes
d3d9helper/IDirect3D9::EnumAdapterModes
c++
APIRef
kbSyntax
COM
D3D9.lib
D3D9.dll
IDirect3D9.EnumAdapterModes

IDirect3D9::EnumAdapterModes

-description

Queries the device to determine whether the specified adapter supports the requested format and display mode. This method could be used in a loop to enumerate all the available adapter modes.

-parameters

-param Adapter [in]

Type: UINT

Ordinal number denoting the display adapter to enumerate. D3DADAPTER_DEFAULT is always the primary display adapter. This method returns D3DERR_INVALIDCALL when this value equals or exceeds the number of display adapters in the system.

-param Format [in]

Type: D3DFORMAT

Allowable pixel formats. See Remarks.

-param Mode [in]

Type: UINT

Represents the display-mode index which is an unsigned integer between zero and the value returned by GetAdapterModeCount minus one.

-param pMode [out]

Type: D3DDISPLAYMODE*

A pointer to the available display mode of type D3DDISPLAYMODE. See Remarks.

-returns

Type: HRESULT

  • If the device can be used on this adapter, D3D_OK is returned.
  • If the Adapter equals or exceeds the number of display adapters in the system, D3DERR_INVALIDCALL is returned.
  • If either surface format is not supported or if hardware acceleration is not available for the specified formats, D3DERR_NOTAVAILABLE is returned.

-remarks

An application supplies a display mode and a format to EnumAdapterModes which returns a display mode. This method could be used in a loop to enumerate all available display modes.

The application specifies a format and the enumeration is restricted to those display modes that exactly match the format (alpha is ignored). Allowed formats (which are members of D3DFORMAT) are as follows:

  • D3DFMT_A1R5G5B5
  • D3DFMT_A2R10G10B10
  • D3DFMT_A8R8G8B8
  • D3DFMT_R5G6B5
  • D3DFMT_X1R5G5B5
  • D3DFMT_X8R8G8B8
In addition, EnumAdapterModes treats pixel formats 565 and 555 as equivalent, and returns the correct version. The difference comes into play only when the application locks the back buffer and there is an explicit flag that the application must set in order to accomplish this.

-see-also

IDirect3D9