IDirectXVideoDecoder::BeginFrame, méthode (dxva2api.h)
Démarre l’opération de décodage.
Syntaxe
HRESULT BeginFrame(
[in] IDirect3DSurface9 *pRenderTarget,
[in] void *pvPVPData
);
Paramètres
[in] pRenderTarget
Pointeur vers l’interface IDirect3DSurface9 de la cible de rendu où le frame décodé sera écrit.
[in] pvPVPData
Réservés au; défini sur NULL.
Valeur retournée
Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.
| Code de retour | Description |
|---|---|
|
S_OK |
|
Type de surface non valide. Consultez la section Notes. |
Notes
Une fois cette méthode appelée, appelez IDirectXVideoDecoder::Execute pour effectuer des opérations de décodage. Lorsque toutes les opérations de décodage ont été exécutées, appelez IDirectXVideoDecoder::EndFrame.
Chaque appel à BeginFrame doit avoir un appel correspondant à EndFrame, et les appels BeginFrame ne peuvent pas être imbriqués.
Remarque sur la migration DXVA 1.0 : Contrairement à la méthode IAMVideoAccelerator::BeginFrame , qui spécifie la mémoire tampon en tant qu’index, cette méthode prend un pointeur directement vers la mémoire tampon non compressée.
La surface pointée par pRenderTarget doit être créée en appelant IDirectXVideoAccelerationService::CreateSurface avec la valeur DXVA2_VideoDecoderRenderTarget pour DxvaType.
Spécifications
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | dxva2api.h |