IBDA_Topology::SetMedium

The SetMedium method configures the medium on which a particular pin sends data.

Syntax

HRESULT SetMedium(
  ULONG  ulPinId,
  REGPINMEDIUM*  pMedium
);

Parameters

  ulPinId

[in]  Specifies the identifier of the pin on which to set the medium.

  pMedium

[in]  Pointer to the medium on which the pin will send data.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

A medium is a structure that identifies a hardware data path between two devices on the host system. They can be devices on the same card, such as a crossbar and a tuner on a TV card; devices on separate cards; or external devices. Kernel-mode filters based on the Windows Driver Model can use mediums instead of media types to determine pin connections.

See Also

• Error and Success Codes
• IBDA_Topology Interface