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 |
|---|---|
|
Erfolg. |
|
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 |