Monitor GetPhysicalMonitorsFromIDirect3DDevice9 Function 

 
Monitor Configuration API
Previous Next

GetPhysicalMonitorsFromIDirect3DDevice9 Function

Retrieves the physical monitors associated with a Direct3D device.

Syntax

  BOOL GetPhysicalMonitorsFromIDirect3DDevice9(
  IDirect3DDevice9 *
    pDirect3DDevice9,

    DWORD
    dwPhysicalMonitorArraySize,

    LPPHYSICAL_MONITOR
    pPhysicalMonitorArray

  );

Parameters

pDirect3DDevice9

[in]  Pointer to the IDirect3DDevice9 interface of the Direct3D device.

dwPhysicalMonitorArraySize

[in]  Number of elements in pPhysicalMonitorArray. To get the required size of the array, call GetNumberOfPhysicalMonitorsFromIDirect3DDevice9.

pPhysicalMonitorArray

[out]  Pointer to an array of PHYSICAL_MONITOR structures. The caller must allocate the array.

Return Value

If the function succeeds, the return value is TRUE. If the function fails, the return value is FALSE. To get extended error information, call GetLastError.

Remarks

A single Direct3D device can be associated with more than one physical monitor. This function returns a handle and a text description for each physical monitor.

When you are done using the monitor handles, close them by passing the pPhysicalMonitorArray array to the DestroyPhysicalMonitors function.

Requirements

Client: Requires Windows Vista.

Header: Include PhysicalMonitorEnumerationAPI.h.

Library: Use dxva2.lib.

See Also

Previous Next