IAsyncReader::RequestAllocator-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 RequestAllocator -Methode fordert während der Pinverbindung eine Zuweisung an.

Syntax

HRESULT RequestAllocator(
  [in]  IMemAllocator        *pPreferred,
  [in]  ALLOCATOR_PROPERTIES *pProps,
  [out] IMemAllocator        **ppActual
);

Parameter

[in] pPreferred

Zeiger auf die IMemAllocator-Schnittstelle auf der bevorzugten Zuweisung des Eingabepins oder NULL.

[in] pProps

Gibt die Adresse einer vom Aufrufer zugeordneten ALLOCATOR_PROPERTIES-Struktur an. Der Aufrufer sollte alle Zuweisungseigenschaften ausfüllen, die für den Eingabenadel erforderlich sind, und die verbleibenden Member auf 0 (null) festlegen.

[out] ppActual

Adresse einer Variablen, die einen IMemAllocator-Schnittstellenzeiger empfängt.

Rückgabewert

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

Rückgabecode Beschreibung
E_FAIL
 Fehler beim Initialisieren einer Zuweisung.
VFW_E_BADALIGN
 Es wurde eine ungültige Ausrichtung angegeben.
S_OK
 Die Zuweisung wurde zurückgegeben.

Hinweise

Der nachgeschaltete Eingabepin sollte diese Methode während des Verbindungsvorgangs aufrufen. Wenn der Pin über eine bevorzugte Zuweisung verfügt, geben Sie ihn im pPreferred-Parameter an. Geben Sie im pProps-Parameter alle Pufferanforderungen an, z. B. Puffergröße oder Ausrichtung. Der Ausgabenadel wählt die Zuweisung aus und gibt im ppActual-Parameter einen Zeiger darauf zurück.

Der Ausgabepin ist nicht erforderlich, um die Anforderungen des Eingabenadels zu berücksichtigen. Wenn der Eingabenadel absolute Anforderungen hat, sollte er die IMemAllocator::GetProperties-Methode für die zurückgegebene Zuweisung aufrufen. Die Verbindung kann fehlschlagen, wenn die Zuweisungseigenschaften nicht geeignet sind. Nachdem die Verbindung hergestellt wurde, muss der Eingabenadel die vom Ausgabepin ausgewählte Zuweisung verwenden.

Der Eingabenadel ist für das Committen und Aufheben der Zuweisung verantwortlich.

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

IAsyncReader-Schnittstelle