Microsoft DirectX 8.1 (C++)

IVPBaseConfig::GetConnectInfo

The GetConnectInfo method retrieves connection information structures.

Syntax

HRESULT GetConnectInfo(
  LPDWORD pdwNumConnectInfo,
  LPDDVIDEOPORTCONNECT pddVPConnectInfo
);

Parameters

pdwNumConnectInfo

[in, out] Pointer to a buffer that contains the number of DDVIDEOPORTCONNECT structures provided by the pddVPConnectInfo parameter. Contains the actual number of structures returned on output. If pddVPConnectInfo is NULL, this method updates this parameter with the number of structures supported by the driver.

pddVPConnectInfo

[in, out] Pointer to an array of DDVIDEOPORTCONNECT structures that the driver fills in. Specify NULL to retrieve the total number of formats supported.

Return Values

Returns S_OK if the count or structures were retrieved, or a driver error.

Remarks

This method retrieves the various connection information structures such as GUID and port width structures, in an array of structures specified by pddVPConnectInfo. The callee must allocate the correct amount of space for the number of structures requested.

Set the index for connection information by using the IVPBaseConfig::SetConnectInfo method.

See Also