IFilterMapper::RegisterPin-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Syntax

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

Parameter

[in] Filter

GUID des Filters.

[in] Name

Name des Pins. Dies sollte innerhalb des Filters eindeutig sein. Es hat keine andere Bedeutung als die Angabe von Typinformationen. Sie sollten keine Pinnamen verwenden, die länger als 99 Zeichen sind, da dies Filterenumerationsprobleme verursacht.

[in] bRendered

Wert, der angibt, ob der Filter diese Eingabe rendert. Legen Sie auf TRUE fest, wenn dies der Fall ist. andernfalls auf FALSE festgelegt.

[in] bOutput

Wert, der angibt, ob es sich um einen Ausgabepin handelt. Legen Sie auf TRUE fest, wenn dies der Fall ist. andernfalls auf FALSE festgelegt.

[in] bZero

Wert, der angibt, ob der Filter keine Instanzen dieses Pins aufweisen kann. Legen Sie, falls möglich, auf TRUE fest. andernfalls auf FALSE festgelegt. Beispielsweise muss ein Dekomprimierungsfilter keinen Soundausgabe-Pin für einen Film ohne Tonspur erstellen.

[in] bMany

Wert, der angibt, ob der Filter viele Instanzen dieser Pin enthalten kann. Legen Sie, falls möglich, auf TRUE fest. andernfalls auf FALSE festgelegt. Beispielsweise kann ein Mixer über mehrere Instanzen seines Eingabestifts verfügen.

[in] ConnectsToFilter

Reserviert. Muss NULL sein. (Dies ist für Filter wie systemweite Mischer vorgesehen, die Verbindungen außerhalb des Filterdiagramms haben. Es ist noch nicht implementiert.)

[in] ConnectsToPin

Reserviert. Muss NULL sein.

Rückgabewert

Gibt einen HRESULT-Wert zurück.

Anforderungen

Weitere Informationen

Fehler- und Erfolgscodes

IFilterMapper-Schnittstelle