IDirectXVideoDecoder::BeginFrame-Methode (dxva2api.h)

Artikel
08/23/2023

Startet den Decodierungsvorgang.

Syntax

HRESULT BeginFrame(
  [in] IDirect3DSurface9 *pRenderTarget,
  [in] void              *pvPVPData
);

Parameter

[in] pRenderTarget

Zeiger auf die IDirect3DSurface9-Schnittstelle des Renderziels, in dem der decodierte Frame geschrieben wird.

[in] pvPVPData

Reserviert; auf NULL festgelegt.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_INVALIDARG	Ungültiger Oberflächentyp. Siehe Hinweise.

Hinweise

Nachdem diese Methode aufgerufen wurde, rufen Sie IDirectXVideoDecoder::Execute auf, um Decodierungsvorgänge auszuführen. Wenn alle Decodierungsvorgänge ausgeführt wurden, rufen Sie IDirectXVideoDecoder::EndFrame auf.

Jeder Aufruf von BeginFrame muss einen übereinstimmenden Aufruf von EndFrame aufweisen, und BeginFrame-Aufrufe können nicht geschachtelt werden.

DXVA 1.0-Migrationshinweis: Im Gegensatz zur IAMVideoAccelerator::BeginFrame-Methode , die den Puffer als Index angibt, verwendet diese Methode einen Zeiger direkt auf den nicht komprimierten Puffer.

Die Oberfläche, auf die pRenderTarget verweist, muss erstellt werden, indem IDirectXVideoAccelerationService::CreateSurface mit dem Wert DXVA2_VideoDecoderRenderTarget für DxvaType aufgerufen wird.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dxva2api.h

Weitere Informationen

DirectX VideoBeschleunigung 2.0

IDirectXVideoDecoder

Share via