Método IMediaDet::WriteBitmapBits

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 Audio/Video Capture in 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 WriteBitmapBits método recupera um quadro de vídeo no tempo de mídia especificado e o grava em um arquivo. O quadro de vídeo está sempre no formato RGB de 24 bits.

Sintaxe

HRESULT WriteBitmapBits(
   double StreamTime,
   long   Width,
   long   Height,
   BSTR   Filename
);

Parâmetros

StreamTime

Hora em que recuperar o quadro de vídeo.

Largura

Largura da imagem, em pixels.

Altura

Altura da imagem, em pixels.

Filename

Caminho do arquivo no qual salvar o bitmap. Se o arquivo já existir, esse método o substituirá.

Retornar valor

Retorna S_OK bem-sucedido. Caso contrário, retorna um valor HRESULT que indica a causa do erro. Os códigos de erro possíveis incluem o seguinte:

Comentários

Antes de chamar esse método, defina o nome do arquivo e o fluxo chamando IMediaDet::p ut_Filename e IMediaDet::p ut_CurrentStream.

Esse método coloca o detector de mídia no modo de captura de bitmap. Depois que esse método for chamado, os vários métodos de informações de fluxo no IMediaDet não funcionarão, a menos que você crie uma nova instância do detector de mídia.

Requisitos

Confira também

IMediaDet Interface

Códigos de erro e êxito