IMemAllocator::SetProperties-Methode (strmif.h)

  • Artikel

[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 SetProperties -Methode gibt die Anzahl der zuzuordnenden Puffer und die Größe der einzelnen Puffer an.

Syntax

HRESULT SetProperties(
  ALLOCATOR_PROPERTIES *pRequest,
  ALLOCATOR_PROPERTIES *pActual
);

Parameter

pRequest

Zeiger auf eine ALLOCATOR_PROPERTIES Struktur, die die Pufferanforderungen enthält.

pActual

Zeiger auf eine ALLOCATOR_PROPERTIES-Struktur , die die tatsächlichen Puffereigenschaften empfängt.

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.
E_POINTER
 NULL-Zeigerargument.
VFW_E_ALREADY_COMMITTED
 Der zugeordnete Arbeitsspeicher kann nicht geändert werden, während der Filter aktiv ist.
VFW_E_BADALIGN
 Es wurde eine ungültige Ausrichtung angegeben.
VFW_E_BUFFERS_OUTSTANDING
 Mindestens ein Puffer ist weiterhin aktiv.

Bemerkungen

Diese Methode gibt die Pufferanforderungen an, weist jedoch keine Puffer zu. Rufen Sie die IMemAllocator::Commit-Methode auf, um Puffer zuzuweisen.

Der Aufrufer ordnet zwei ALLOCATOR_PROPERTIES-Strukturen zu. Der Parameter pRequest enthält die Pufferanforderungen des Aufrufers, einschließlich der Anzahl der Puffer und der Größe jedes Puffers. Wenn die Methode zurückgibt, enthält der pActual-Parameter die tatsächlichen Puffereigenschaften, wie vom Allocator festgelegt.

Wenn diese Methode aufgerufen wird, darf für die Zuweisung kein Commit ausgeführt werden oder über ausstehende Puffer verfügen.

Anforderungen

   
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

Siehe auch

Fehler- und Erfolgscodes

IMemAllocator-Schnittstelle