ISampleGrabber::SetCallback (método)
[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 método SetCallback especifica un método de devolución de llamada para llamar a en los ejemplos entrantes.
Sintaxis
HRESULT SetCallback(
ISampleGrabberCB *pCallback,
long WhichMethodToCallback
);
Parámetros
-
pCallback
-
Puntero a una interfaz ISampleGrabberCB que contiene el método de devolución de llamada o NULL para cancelar la devolución de llamada.
-
WhichMethodToCallback
-
Índice que especifica el método de devolución de llamada. Debe ser uno de los siguientes valores:
Valor Descripción 0 El filtro Sample Grabber llama al método ISampleGrabberCB::SampleCB . Este método recibe un puntero IMediaSample . 1 El filtro Sample Grabber llama al método ISampleGrabberCB::BufferCB . Este método recibe un puntero al búfer contenido en el ejemplo multimedia.
Valor devuelto
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Observaciones
El subproceso de procesamiento de datos se bloquea hasta que se devuelva el método de devolución de llamada. Si la devolución de llamada no se devuelve rápidamente, puede interferir con la reproducción.
El filtro no invoca la función de devolución de llamada para ejemplos de inscripción previa o para ejemplos en los que el miembro dwStreamId de la estructura AM_SAMPLE2_PROPERTIES es distinto de AM_STREAM_MEDIA.
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