DirectX SDK

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 is to be retrieved.
lpNumEntries
Address of a variable that contains 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 all the entries that 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 to 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 it fails, the method can return one of the following error values:

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_MOREDATA

Requirements

  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.