Edit

Share via

IDirect3D9Ex::GetAdapterModeCountEx method (d3d9.h)

  • Article

Returns the number of display modes available.

Syntax

UINT GetAdapterModeCountEx(
  [in] UINT                       Adapter,
  [in] const D3DDISPLAYMODEFILTER *pFilter
);

Parameters

[in] Adapter

Type: UINT

Ordinal number denoting the display adapter from which to retrieve the display mode count.

[in] pFilter

Type: const D3DDISPLAYMODEFILTER*

Specifies the characteristics of the desired display mode. See D3DDISPLAYMODEFILTER.

Return value

Type: UINT

The number of display modes available. A return of value zero from this method is an indication that no such display mode is supported or simply this monitor is no longer available.

Remarks

Events such as display mode changes on other heads of the same hardware, monitor change or its connection status change, and desktop extension/unextension could all affect the number of display mode available.

To fullscreen applications, S_PRESENT_MODE_CHANGED returned from PresentEx or CheckDeviceState is the indication of display mode setting failure due to those events.

To increase the chance of setting a currently available display mode successfully, fullscreen applications should try to requery the available display mode list upon receiving S_PRESENT_MODE_CHANGED.

Requirements

Requirement Value
Target Platform Windows
Header d3d9.h
Library D3D9.lib

See also

IDirect3D9Ex