Compartilhar via


Método IMediaDet::EnterBitmapGrabMode

[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 EnterBitmapGrabMode método alterna o detector de mídia para o modo de captura de bitmap e busca o grafo de filtro para um horário especificado.

Sintaxe

HRESULT EnterBitmapGrabMode(
   double StreamTime
);

Parâmetros

StreamTime

Tempo, em segundos, ao qual o grafo busca.

Retornar valor

Retorna um valor HRESULT . Os possíveis valores incluem os seguintes:

Código de retorno Descrição
S_OK
Êxito.
E_INVALIDARG
Argumento inválido.
VFW_E_INVALIDMEDIATYPE
O arquivo de origem não tem um fluxo de vídeo.
VFW_E_TIME_EXPIRED
O comando Seek atingiu o tempo limite.

 

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 insere o filtro Grabber de Exemplo no grafo de filtro. Em seguida, você pode chamar IMediaDet::GetSampleGrabber para obter um ponteiro para a interface ISampleGrabber . Depois que o detector de mídia entrar no modo de captura de bitmap, os vários métodos informativos no IMediaDet não funcionarão.

Os métodos IMediaDet::GetBitmapBits ou IMediaDet::WriteBitmapBits também colocam o detector de mídia no modo de captura de bitmap.

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
Qedit.h
Biblioteca
Strmiids.lib

Confira também

IMediaDet Interface

Códigos de erro e êxito