IMemInputPin::GetAllocator-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 GetAllocator -Methode ruft die von diesem Pin vorgeschlagene Speicherzuweisung ab. Nachdem die Zuweisung ausgewählt wurde, gibt diese Methode einen Zeiger auf die ausgewählte Zuweisung zurück.

Syntax

HRESULT GetAllocator(
  [out] IMemAllocator **ppAllocator
);

Parameter

[out] ppAllocator

Empfängt einen Zeiger auf die IMemAllocator-Schnittstelle der Zuweisung. Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

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

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
VFW_E_NO_ALLOCATOR	Es ist keine Zuweisung verfügbar.

Hinweise

Wenn ein Ausgabepin eine Verbindung mit einem Eingabenadel herstellt, verhandelt er mit dem Eingabestift, um sich für eine Speicherzuweisung zu entscheiden. Der Ausgabepin ruft diese Methode auf, um die vorgeschlagene Zuweisung des Eingabepins abzurufen. Sie ruft die IMemInputPin::NotifyAllocator-Methode auf, um anzugeben, welche Zuweisung ausgewählt wurde.

Wenn diese Methode erfolgreich ist, weist die IMemAllocator-Schnittstelle eine ausstehende Verweisanzahl auf. Stellen Sie sicher, dass Sie es freigeben, wenn Sie fertig sind.

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