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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
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 |