Share via


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

Header Declared in Bdaiface.h.

See Also

Error and Success Codes
IBDA_Topology Interface

Send comments about this topic to Microsoft

Build date: 12/4/2008