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.]
Observação
[Preterido. Essa API pode ser removida de versões futuras do Windows.]
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:
| Código de retorno | Descrição |
|---|---|
|
Não foi possível adicionar o filtro de Captura de Exemplo ao grafo. |
|
Falha. |
|
Memória insuficiente. |
|
Erro inesperado. |
|
Não é possível substituir o arquivo. |
|
Tipo de mídia inválido. |
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.
Observação
O arquivo de cabeçalho Qedit.h não é compatível com cabeçalhos Direct3D posteriores à versão 7.
Observação
Para obter qedit.h, baixe o SDK do Microsoft Windows Update para Windows Vista e .NET Framework 3.0. O Qedit.h não está disponível no SDK do Microsoft Windows para Windows 7 e .NET Framework 3.5 Service Pack 1.
Requisitos
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|
Confira também