Método CCmdQueue.New
[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.
El New método inicializa un comando que se va a ejecutar y devuelve un nuevo objeto CDeferredCommand .
Sintaxis
virtual HRESULT New(
CDeferredCommand **ppCmd,
LPUNKNOWN pUnk,
REFTIME time,
GUID *iid,
long dispidMethod,
short wFlags,
long cArgs,
VARIANT *pDispParams,
VARIANT *pvarResult,
short *puArgErr,
BOOL bStream
);
Parámetros
-
ppCmd
-
Dirección de un puntero a un objeto CDeferredCommand mediante el que una aplicación puede cancelar el comando, establecer una nueva hora de presentación para él o recuperar información de estimación.
-
pUnk
-
Puntero al objeto que ejecutará el comando.
-
time
-
Hora en la que se ejecutarán los comandos o comandos en cola.
-
iid
-
Puntero al identificador único global (GUID) de la interfaz que se va a llamar.
-
dispidMethod
-
Método en la interfaz a la que se va a llamar.
-
wFlags
-
Marcas que describen el contexto de la llamada. Este parámetro admite las mismas marcas que el método IDispatch::Invoke .
-
cArgs
-
Número de argumentos pasados.
-
pDispParams
-
Puntero a la lista de tipos de variante asociados a los parámetros de distribución.
-
pvarResult
-
Puntero a la lista donde se devolverán los resultados, si los hay.
-
puArgErr
-
Puntero al índice dentro de la lista de parámetros pDispParams donde se produjo el último error.
-
bStream
-
Valor que indica si el parámetro time es un valor de tiempo de secuencia (TRUE) o un valor de tiempo de presentación (FALSE).
Valor devuelto
Devuelve S_OK si se ejecuta correctamente. Devuelve E_OUTOFMEMORY si ppCmd devuelve la creación del nuevo objeto CDeferredCommand con un valor NULL. De lo contrario, devuelve un VALOR HRESULT que indica un error al intentar crear un nuevo objeto CDeferredCommand . Si se produce un error, no se ha puesto en cola ningún objeto.
Observaciones
El nuevo objeto CDeferredCommand se inicializará con los parámetros y se agregará a la cola durante la construcción. Este método es similar al método IDispatch::Invoke .
Entre los valores del parámetro wFlags se incluyen los siguientes:
| Valor | Descripción |
|---|---|
| DISPATCH_METHOD | El miembro se ejecuta como un método . Si una propiedad tiene el mismo nombre, se puede establecer tanto esto como la marca DISPATCH_PROPERTYGET. |
| DISPATCH_PROPERTYGET | El miembro se está recuperando como propiedad o miembro de datos. |
| DISPATCH_PROPERTYPUT | El miembro se cambia como propiedad o miembro de datos. |
| DISPATCH_PROPERTYPUTREF | El miembro se cambia a través de una asignación de referencia, en lugar de una asignación de valor. Este valor solo es válido cuando la propiedad acepta una referencia a un objeto . |
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|