CImageAllocator.Alloc-Methode

[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 Alloc -Methode weist arbeitsspeicher für die Puffer zu. Diese Methode setzt die CBaseAllocator::Alloc-Methode außer Kraft.

Syntax

HRESULT Alloc();

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolgreich
E_OUTOFMEMORY	Der Arbeitsspeicher reicht nicht aus

Bemerkungen

Diese Methode wird von der CBaseAllocator::Commit-Methode aufgerufen, wenn der Filter den Zuweisungsvorgang committ.

Diese Methode erstellt eine Liste von Medienbeispielen, die als CImageSample-Objekte implementiert werden. Jedes Beispiel enthält eine geräteunabhängige GDI-Bitmap, die die GDI CreateDIBSection-Funktion verwendet.

Intern ruft diese Methode CImageAllocator::CreateDIB auf, um jeden DIB zu erstellen, und CImageAllocator::CreateImageSample , um jedes Beispiel zu erstellen.

Anforderungen

Anforderung	Wert
Header	Winutil.h (streams.h einschließen)
Bibliothek	Strmbase.lib (Einzelhandelsbuilds); Strmbasd.lib (Debugbuilds)

Siehe auch

CImageAllocator-Klasse