共用方式為


IVPBaseConfig::GetConnectInfo

 
Microsoft DirectShow 9.0

IVPBaseConfig::GetConnectInfo

The GetConnectInfo method retrieves information about the connections supported by the VPE object.

Syntax

  HRESULT GetConnectInfo(
  DWORD *pdwNumConnectInfo,
  DDVIDEOPORTCONNECT *pddVPConnectInfo
);

Parameters

pdwNumConnectInfo

[in, out] Pointer to a variable that specifies the number of DDVIDEOPORTCONNECT structures in the pddVPConnectInfo array. On input, specifies the size of the array (in number of array elements). On ouput, contains the actual number of DDVIDEOPORTCONNECT structures that were copied into the array. If pddVPConnectInfo is NULL, the method returns the required array size.

pddVPConnectInfo

[in, out] Pointer to an array of DDVIDEOPORTCONNECT structures, allocated by the caller. The device fills in the array with the connection information.

Return Values

Returns S_OK if successful, or an error code otherwise.

Remarks

The client first calls this method with the value NULL for the pddVPConnectInfo parameter. The device returns the number of DDVIDEOPORTCONNECT structures in the pdwNumConnectInfo parameter. The client allocates an array of that size, and calls the method again, passing the address of the array in the pddVPConnectInfo parameter. The device copies the connection information into the buffer, and returns the actual number of copied structures in the pdwNumConnectInfo parameter.

The DDVIDEOPORTCONNECT structure is documented in the Windows DDK. The device can translate this method directly into an DdVideoPortGetConnectInfo call.

The client sets the connection information by calling the IVPBaseConfig::SetConnectInfo method with an index number, which references one of the connection structures returned by this method.

Requirements

Header: Include Dvp.h, Vptype.h, Vpconfig.h.

Library: None.

See Also