Método IMFAsyncCallback::GetParameters (mfobjects.h)

  • Artículo

Proporciona información de configuración al subproceso de distribución para una devolución de llamada.

Sintaxis

HRESULT GetParameters(
  [out] DWORD *pdwFlags,
  [out] DWORD *pdwQueue
);

Parámetros

[out] pdwFlags

Recibe una marca que indica el comportamiento del método IMFAsyncCallback::Invoke del objeto de devolución de llamada. Se definen los valores siguientes. El valor predeterminado es cero.

Valor Significado
Cero
 La devolución de llamada no tarda mucho tiempo en completarse, pero no tiene restricciones específicas en lo que el sistema llama. La devolución de llamada suele tardar menos de 30 milisegundos en completarse.
MFASYNC_FAST_IO_PROCESSING_CALLBACK
 La devolución de llamada realiza un procesamiento muy mínimo. Se tarda menos de 1 milisegundo en completarse.

La devolución de llamada debe invocarse desde una de las siguientes colas de trabajo:

  • MFASYNC_CALLBACK_QUEUE_IO
  • MFASYNC_CALLBACK_QUEUE_TIMER
MFASYNC_SIGNAL_CALLBACK
 Implica MFASYNC_FAST_IO_PROCESSING_CALLBACK, con la restricción adicional que la devolución de llamada no procesa (menos de 50 microsegundos) y la única llamada del sistema que realiza es SetEvent.

La devolución de llamada debe invocarse desde una de las siguientes colas de trabajo:

  • MFASYNC_CALLBACK_QUEUE_IO
  • MFASYNC_CALLBACK_QUEUE_TIMER
MFASYNC_BLOCKING_CALLBACK
 Bloqueo de devolución de llamada.
MFASYNC_REPLY_CALLBACK
 Devolución de llamada de respuesta.

[out] pdwQueue

Recibe el identificador de la cola de trabajo en la que se envía la devolución de llamada.

Este valor puede especificar una de las colas de trabajo estándar de Media Foundation o una cola de trabajo creada por la aplicación. Para obtener una lista de las colas de trabajo estándar de Media Foundation, consulte Identificadores de cola de trabajo. Para crear una nueva cola de trabajo, llame a MFAllocateWorkQueue. El valor predeterminado es MFASYNC_CALLBACK_QUEUE_STANDARD.

Si la cola de trabajo no es compatible con el valor devuelto en pdwFlags, la plataforma Media Foundation devuelve MF_E_INVALID_WORKQUEUE cuando intenta enviar la devolución de llamada. (Consulte MFPutWorkItem).

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
E_NOTIMPL
 Sin implementar. Supongamos el comportamiento predeterminado.

Comentarios

El método GetParameters devuelve información sobre la devolución de llamada para que el subproceso de distribución pueda optimizar el proceso que usa para invocar la devolución de llamada.

Si el método devuelve un valor distinto de cero en el parámetro pdwFlags , el método Invoke debe cumplir los requisitos descritos aquí. De lo contrario, la devolución de llamada podría retrasar la canalización.

Si desea valores predeterminados para ambos parámetros, devuelva E_NOTIMPL. Los valores predeterminados se proporcionan en las descripciones de parámetros de esta página.

Esta interfaz está disponible en las siguientes plataformas si se instalan los componentes redistribuibles del SDK de Windows Media Format 11:

  • Windows XP con Service Pack 2 (SP2) y versiones posteriores.
  • Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) y KB925766 (paquete acumulativo de actualizaciones de octubre de 2006 para Windows XP Media Center Edition) instalados.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado mfobjects.h (include Mfidl.h)
Library Mfuuid.lib

Consulte también

Métodos de devolución de llamada asincrónica

IMFAsyncCallback

Colas de trabajo