IMemInputPin::NotifyAllocator-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.]

Die NotifyAllocator -Methode gibt eine Zuweisung für die Verbindung an.

Syntax

HRESULT NotifyAllocator(
  [in]  IMemAllocator *pAllocator,
  [out] BOOL          bReadOnly
);

Parameter

[in] pAllocator

Zeiger auf die IMemAllocator-Schnittstelle der Zuweisung.

[out] bReadOnly

Flag, das angibt, ob Beispiele aus dieser Zuweisung schreibgeschützt sind. Bei TRUE sind die Beispiele schreibgeschützt.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK oder einen HRESULT-Wert zurück, der die Fehlerursache angibt.

Hinweise

Während der Pinverbindung wählt der Ausgabepin eine Zuweisung aus und ruft diese Methode auf, um den Eingabepin zu benachrichtigen. Der Ausgabepin kann die Zuweisung verwenden, die der Eingabenadel in der IMemInputPin::GetAllocator-Methode vorgeschlagen hat, oder er kann eine eigene Zuweisung bereitstellen.

Wenn der bReadOnly-ParameterTRUE ist, sind alle Beispiele in der Zuweisung schreibgeschützt. Der Filter muss sie kopieren, um die Daten zu ändern.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile strmif.h (include Dshow.h)
Bibliothek Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IMemInputPin-Schnittstelle