Share via

IVMRMonitorConfig::GetAvailableMonitors

  • Article
 
Microsoft DirectShow 9.0

IVMRMonitorConfig::GetAvailableMonitors

The GetAvailableMonitors method retrieves information about the monitors currently available on the system.

Syntax

  
  HRESULT GetAvailableMonitors(

  
  VMRMONITORINFO*
  
  pInfo
  ,

  
  DWORD
  
  dwMaxInfoArraySize
  ,

  
  DWORD*
  
  pdwNumDevices

  );

pInfo

[out]  Pointer to an array of VMRMONITORINFO structures that contain information about each monitor on the system.

dwMaxInfoArraySize

[in]  Specifies the maximum number of members in the array.

pdwNumDevices

[out]  Pointer to a variable that receives the number of devices retrieved.

Return Values

Returns an HRESULT value. Possible values include the following.

Value Description
E_INVALIDARG Invalid argument; dwMaxInfoArraySize must be greater than zero.
E_POINTER NULL pointer argument.
S_OK Success.

Remarks

Use this method to get a list of DirectDraw device GUIDs and their associated monitor information that the VMR can use when connecting to an upstream decoder filter. To return the required array size in the pdwNumDevices parameter, specify NULL for pInfo.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also