Edit

REGPINMEDIUM structure (strmif.h)

  • Article

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The REGPINMEDIUM structure describes a pin medium for registration through the IFilterMapper2 interface.

Syntax

typedef struct REGPINMEDIUM {
  CLSID clsMedium;
  DWORD dw1;
  DWORD dw2;
} REGPINMEDIUM;

Members

clsMedium

GUID that specifies the medium.

dw1

Variable of type DWORD that specifies the instance of this medium. This is necessary when two identical devices are present on the host system.

dw2

Not used.

Remarks

A medium identifies a hardware path of communication that exists within a single hardware device or between two devices. Register mediums if your filter is built on kernel streaming pins and needs to connect to other such filters.

This structure is equivalent to the KSPIN_MEDIUM structure, which is used by kernel streaming drivers.

Requirements

Requirement Value
Header strmif.h (include Dshow.h)

See also

DirectShow Structures

KSMULTIPLE_ITEM