Método IMediaDet::GetSampleGrabber
[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
Nota:
[Desusado. Esta API se puede quitar de futuras versiones de Windows.
El GetSampleGrabber método recupera un puntero a la interfaz ISampleGrabber , que permite a una aplicación recuperar ejemplos individuales de una secuencia multimedia.
Sintaxis
HRESULT GetSampleGrabber(
[out] ISampleGrabber **ppVal
);
Parámetros
-
ppVal [out]
-
Recibe un puntero a la interfaz ISampleGrabber .
Valor devuelto
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Observaciones
Llame a IMediaDet::EnterBitmapGrabMode antes de llamar a este método. La interfaz ISampleGrabber permite recuperar ejemplos de medios individuales de la secuencia. Si solo necesita un mapa de bits de un fotograma de vídeo, llame al método IMediaDet::GetBitmapBits en su lugar. La interfaz ISampleGrabber es más flexible, pero requiere más trabajo por parte de la aplicación.
Si este método se realiza correctamente, la interfaz ISampleGrabber que devuelve tiene un recuento de referencias pendiente. Asegúrese de liberar la interfaz cuando haya terminado de usarlo.
Nota:
El archivo de encabezado Qedit.h no es compatible con los encabezados de Direct3D posteriores a la versión 7.
Nota:
Para obtener Qedit.h, descargue la actualización de Microsoft Windows SDK para Windows Vista y .NET Framework 3.0. Qedit.h no está disponible en el Microsoft Windows SDK para Windows 7 y .NET Framework 3.5 Service Pack 1.
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|
Consulte también