IDirect3D9Ex::GetAdapterModeCountEx method

Returns the number of display modes available.

Syntax


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

Parameters

Adapter [in]

Type: UINT

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

pFilter [in]

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

Header

D3d9.h

Library

D3D9.lib

See also

IDirect3D9Ex

 

 

Community Additions

ADD
Show:
© 2014 Microsoft