CTransInPlaceInputPin.NotifyAllocator-Methode

Artikel
07/28/2023

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die NotifyAllocator -Methode gibt einen Zuteilungsgeber für die Verbindung an. Diese Methode implementiert die IMemInputPin::NotifyAllocator-Methode .

Syntax

HRESULT NotifyAllocator(
   IMemAllocator *pAllocator,
   BOOL          bReadOnly
);

Parameter

pAllocator: Zeiger auf die IMemAllocator-Schnittstelle des Zuteilungsgebers.
bReadOnly: Flag, das angibt, ob Die Beispiele dieser Zuweisung schreibgeschützt sind. Bei TRUE sind die Beispiele schreibgeschützt.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Mögliche Werte sind die in der folgenden Tabelle gezeigten Werte.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolgreich
E_FAIL	Fehler
E_POINTER	NULL-Zeigerargument

Bemerkungen

Der Filter versucht, denselben Zuteilungsgeber für beide Pinverbindungen zu verwenden.

Wenn der Ausgabestift nicht verbunden ist, akzeptiert der Eingabestift automatisch den Zuteilungsstift. Wenn der Ausgabepin verbunden ist, verbindet der Filter den Eingabenadel erneut. An diesem Punkt versucht der Filter erneut, einen einzelnen Zuteilungsgeber zu verwenden.
Wenn der Ausgabestift verbunden ist, akzeptiert der Eingabenadel den Zuteilungsstift. Der Ausgabenadel verwendet auch denselben Zuteilungsgeber. Sie ruft NotifyAllocator den nachgeschalteten Eingabenadel auf.

Der vorherige Fall weist die folgende Ausnahme auf:

Wenn die vorgeschlagene Zuweisung schreibgeschützt ist (d. h. der bReadOnly-Parameter ist TRUE), und der Filter die Beispiele ändern muss, muss der Filter zwei verschiedene Zuordnungen verwenden. In diesem Fall gibt die Methode E_FAIL zurück, wenn der Upstream-Filter vorschlägt, den Zuteilungsgeber des Downstreamfilters zu verwenden.

Anforderungen

Anforderung	Wert
Header	Transip.h (include Streams.h)
Bibliothek	Strmbase.lib (Einzelhandelsbuilds); Strmbasd.lib (Debugbuilds)

Siehe auch

CTransInPlaceInputPin-Klasse

Freigeben über