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

Consulte también

Uso del agarrador de ejemplo

ISampleGrabber (interfaz)