Partilhar via

Método CCmdQueue.New

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O New método inicializa um comando a ser executado e retorna um novo objeto CDeferredCommand .

Sintaxe

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

Endereço de um ponteiro para um objeto CDeferredCommand pelo qual um aplicativo pode cancelar o comando, definir um novo tempo de apresentação para ele ou recuperar informações de estimativa.

pUnk

Ponteiro para o objeto que executará o comando .

time

Hora em que executar o comando ou os comandos enfileirados.

iid

Ponteiro para o GUID (identificador global exclusivo) da interface a ser chamada.

dispidMethod

Método na interface a ser chamada.

wFlags

Sinalizadores que descrevem o contexto da chamada. Esse parâmetro dá suporte aos mesmos sinalizadores que o método IDispatch::Invoke .

Cargs

Número de argumentos passados.

Pdispparams

Ponteiro para a lista de tipos variantes associados aos parâmetros de expedição.

Pvarresult

Ponteiro para a lista em que os resultados, se houver, devem ser retornados.

Puargerr

Ponteiro para o índice na lista de parâmetros pDispParams em que ocorreu o último erro.

bStream

Valor que indica se o parâmetro time é um valor de tempo de fluxo (TRUE) ou um valor de tempo de apresentação (FALSE).

Retornar valor

Retorna S_OK se tiver êxito. Retorna E_OUTOFMEMORY se ppCmd retornar da criação do novo objeto CDeferredCommand com um valor NULL. Caso contrário, retorna um HRESULT que indica um erro ao tentar criar um novo objeto CDeferredCommand . Se houver um erro, nenhum objeto foi enfileirado.

Comentários

O novo objeto CDeferredCommand será inicializado com os parâmetros e será adicionado à fila durante a construção. Esse método é semelhante ao método IDispatch::Invoke .

Os valores para o parâmetro wFlags incluem o seguinte:

Valor Descrição
DISPATCH_METHOD O membro está sendo executado como um método . Se uma propriedade tiver o mesmo nome, esse e o sinalizador DISPATCH_PROPERTYGET poderão ser definidos.
DISPATCH_PROPERTYGET O membro está sendo recuperado como uma propriedade ou membro de dados.
DISPATCH_PROPERTYPUT O membro está sendo alterado como uma propriedade ou membro de dados.
DISPATCH_PROPERTYPUTREF O membro está sendo alterado por meio de uma atribuição de referência, em vez de uma atribuição de valor. Esse valor é válido somente quando a propriedade aceita uma referência a um objeto .

Requisitos

Requisito Valor
parâmetro
Winutil.h (inclua Streams.h)
Biblioteca
Strmbase.lib (builds de varejo);
Strmbasd.lib (builds de depuração)

Confira também

Classe CCmdQueue