IDirectXVideoDecoder::BeginFrame-Methode (dxva2api.h)

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