PIN_INFO structure (strmif.h)

[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 PIN_INFO structure contains information about a pin.

Syntax

typedef struct _PinInfo {
  IBaseFilter   *pFilter;
  PIN_DIRECTION dir;
  WCHAR         achName[128];
} PIN_INFO;

Members

pFilter

Pointer to the IBaseFilter interface of the owning filter.

dir

Direction of the pin (input or output).

achName[128]

Name of the pin.

Remarks

If the name of an output pin begins with a tilde (~), the filter graph manager ignores the pin when it builds a graph. During a call to IGraphBuilder::Connect, IGraphBuilder::Render, or IGraphBuilder::RenderFile, if the pin appears on an intermediate filter, the filter graph manager does not render the pin. However, it renders the pin if you explicitly pass the pin to the Connect or Render method.

Use a tilde if the pin delivers a secondary stream that should not be rendered by default, or if the pin requires special code to render correctly. For example, DVD filters should use it for pins that deliver subpicture or closed captioning data. Video capture filters should use it for capture pins (but not preview pins).

The pFilter member has an outstanding reference count. The application must release the interface.

Requirements

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

See also

DirectShow Structures

IPin::QueryPinInfo