Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This method 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,
  LPWSTR 
ConnectsToPin
);

Parameters

Filter

[in] Globally unique identifier (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. Note that pin names longer than 99 characters should not be used, because this causes filter enumeration problems.

bRendered

[in] Set to TRUE if the filter renders this input; otherwise, set to FALSE.

bOutput

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

bZero

[in] If the filter can have zero instances of this pin, set to TRUE; otherwise, set to FALSE. For example, a decompression filter might choose to not create a sound output pin for a movie without a sound track.

bMany

[in] If the filter can have many instances of this pin, 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 HRESULTvalue.

Requirements

Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 and later
Note Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements
For more information, see Setting Up the Build Environment,
Version 2.12 requires DXPAK 1.0 or later

See Also