IBDA_Topology::SetMedium Method

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

Syntax

HRESULT SetMedium(
  [in]  ULONG ulPinId,
  [in]  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 Value

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.

Requirements

See Also

Error and Success Codes
IBDA_Topology Interface

Send comments about this topic to Microsoft

Build date: 12/4/2008