Compartir a través de


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

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

Syntax

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 siguientes valores. El valor predeterminado es cero.

Importancia Meaning
Zero
La devolución de llamada no tarda mucho tiempo en completarse, pero no tiene restricciones específicas en lo que hace el sistema. 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. Tarda menos de 1 milisegundos 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 la 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 HRESULT. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente.

Código de retorno Description
S_OK
El método se ha llevado a cabo de forma correcta.
E_NOTIMPL
No implementado. Supongamos el comportamiento predeterminado.

Observaciones

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) instalado.

Requisitos

Requirement Importancia
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo admitido Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de Windows
Header mfobjects.h (include Mfidl.h)
Library Mfuuid.lib

Consulte también

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

IMFAsyncCallback

Colas de trabajo