Microsoft DirectX 9.0

IFilterMapper::RegisterPin

Note   The IFilterMapper interface is deprecated. Use IFilterMapper2 instead.

Records the details of the pin in the registry.

Syntax

HRESULT RegisterPin(
    CLSID Filter,
    LPCWSTR Name,
    BOOL bRendered,
    BOOL bOutput,
    BOOL bZero,
    BOOL bMany,
    CLSID ConnectsToFilter,
    LPCWSTR ConnectsToPin
);

Parameters

Filter

[in] GUID of the filter.

Name

[in] Name of the pin. This should be unique within the filter. It has no significance other than to indicate type information. You should not use pin names longer than 99 characters, because this causes filter enumeration problems.

bRendered

[in] Value specifying whether the filter renders this input. Set to TRUE if it does; otherwise, set to FALSE.

bOutput

[in] Value specifying whether this is an output pin. Set to TRUE if it is; otherwise, set to FALSE.

bZero

[in] Value specifying whether the filter can have zero instances of this pin. If it can, set to TRUE; otherwise, set to FALSE. For example, a decompression filter doesn't need to create a sound output pin for a movie without a sound track.

bMany

[in] Value specifying whether the filter can have many instances of this pin. If it can, set to TRUE; otherwise, set to FALSE. For example, a mixer might have multiple instances of its input pin.

ConnectsToFilter

[in] Reserved. Must be NULL. (This is intended for filters such as system-wide mixers that have connections outside the filter graph. It is not yet implemented.)

ConnectsToPin

[in] Reserved. Must be NULL.

Return Value

Returns an HRESULT value.

See Also