IDDVideoPortContainer::GetVideoPortConnectInfo

The IDDVideoPortContainer::GetVideoPortConnectInfo method retrieves the connection information supported by all video ports.

HRESULT GetVideoPortConnectInfo(

DWORD dwPortId,

LPDWORD lpNumEntries,

LPDDVIDEOPORTCONNECT lpConnectInfo

);

Parameters

dwPortId

Video port ID of the video port for which the connection information will be retrieved.

lpNumEntries

Address of a variable containing the number of entries that the array at lpConnectInfo can hold. If this number is less than the total number of connections, the method fills the array with as many entries as will fit, sets the value at lpNumEntries to indicate the total number of connections, and returns DDERR_MOREDATA.

lpConnectInfo

Address of an array of DDVIDEOPORTCONNECT structures that will be filled with the connection options supported by the specified video port. If this parameter is NULL, the method sets lpNumEntries to indicate the total number of connections that the video port supports, then returns DD_OK.

Return Values

If the method succeeds, the return value is DD_OK.

If the method fails, the return value may be one of the following error values:

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in dvp.h.
  Import Library: Use ddraw.lib.