PIN_INFO Structure

The PIN_INFO structure contains information about a pin.

Syntax

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

Members

pFilter

Pointer to the IBaseFilter interface of the owning filter.

dir

Direction of the pin (input or output).

achName

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.

See Also

• DirectShow Structures
• IPin::QueryPinInfo