Método IMediaDet::GetSampleGrabber
[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 GetSampleGrabber método recupera um ponteiro para a interface ISampleGrabber , que permite que um aplicativo recupere amostras individuais de um fluxo de mídia.
Sintaxe
HRESULT GetSampleGrabber(
[out] ISampleGrabber **ppVal
);
Parâmetros
-
ppVal [out]
-
Recebe um ponteiro para a interface ISampleGrabber .
Retornar valor
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Chame IMediaDet::EnterBitmapGrabMode antes de chamar esse método. A interface ISampleGrabber permite recuperar amostras de mídia individuais do fluxo. Se você precisar apenas de um bitmap de um quadro de vídeo, chame o método IMediaDet::GetBitmapBits . A interface ISampleGrabber é mais flexível, mas requer mais trabalho do aplicativo.
Se esse método for bem-sucedido, a interface ISampleGrabber retornada terá uma contagem de referência pendente. Certifique-se de liberar a interface quando terminar de usá-la.
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