Método IDirectXVideoDecoder::BeginFrame (dxva2api.h)

  • Artículo

Inicia la operación de descodificación.

Sintaxis

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

Parámetros

[in] pRenderTarget

Puntero a la interfaz IDirect3DSurface9 del destino de representación donde se escribirá el marco descodificado.

[in] pvPVPData

Reservados; se establece en NULL.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
E_INVALIDARG
 Tipo de superficie no válido. Vea la sección Comentarios.

Comentarios

Después de llamar a este método, llame a IDirectXVideoDecoder::Execute para realizar operaciones de descodificación. Cuando se hayan ejecutado todas las operaciones de descodificación, llame a IDirectXVideoDecoder::EndFrame.

Cada llamada a BeginFrame debe tener una llamada coincidente a EndFrame y las llamadas BeginFrame no se pueden anidar.

Nota de migración de DXVA 1.0: A diferencia del método IAMVideoAccelerator::BeginFrame , que especifica el búfer como índice, este método toma un puntero directamente al búfer sin comprimir.

La superficie a la que apunta pRenderTarget debe crearse llamando a IDirectXVideoAccelerationService::CreateSurface con el valor DXVA2_VideoDecoderRenderTarget para DxvaType.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado dxva2api.h

Consulte también

Aceleración de vídeo de DirectX 2.0

IDirectXVideoDecoder