Método IVMRSurfaceAllocator::P repareSurface (strmif.h)

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O PrepareSurface método prepara a superfície DirectDraw para que o próximo quadro de vídeo seja decodificado nela.

Sintaxe

HRESULT PrepareSurface(
  [in] DWORD_PTR            dwUserID,
  [in] LPDIRECTDRAWSURFACE7 lpSurface,
  [in] DWORD                dwSurfaceFlags
);

Parâmetros

[in] dwUserID

Um cookie de DWORD_PTR definido pelo aplicativo que identifica exclusivamente essa instância da VMR para uso em cenários em que uma instância do alocador-apresentador é usada com várias instâncias de VMR.

[in] lpSurface

Especifica a superfície DirectDraw

[in] dwSurfaceFlags

Palavra dupla que contém os sinalizadores de superfície. Consulte Observações.

Valor retornado

Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.

Comentários

O único sinalizador que a VMR verifica atualmente aqui é AM_GBF_NOTASYNCPOINT (0x00000002), o que indica que você não preencherá esse buffer com um ponto de sincronização (quadro-chave).

Requisitos

Confira também

IVMRSurfaceAllocator Interface

Usando o Renderizador de Combinação de Vídeo