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: Identifier 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:

DDERR_INVALIDOBJECT

DDERR_INVALIDPARAMS

DDERR_MOREDATA

QuickInfo

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dvp.h.
  Import Library: Use ddraw.lib.