Método CUnknown.NonDelegatingQueryInterface

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 Audio/Video Capture in 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.]

Recupera um ponteiro de interface e incrementa a contagem de referência. Esse método implementa o método INonDelegatingUnknown::NonDelegatingQueryInterface .

Sintaxe

HRESULT NonDelegatingQueryInterface(
   REFIID riid,
   void   **ppv
);

Parâmetros

riid

Identificador da interface.

ppv

Endereço de um ponteiro para receber a interface.

Retornar valor

Retorna um dos valores HRESULT mostrados na tabela a seguir.

Código de retorno Descrição
S_OK
 Êxito.
E_NOINTERFACE
 O objeto não dá suporte a essa interface.
E_POINTER
 Argumento de ponteiro NULL.

Comentários

A classe CUnknown expõe apenas a interface IUnknown . Substitua esse método para expor interfaces adicionais. Para obter informações sobre como substituir esse método, consulte How to Implement IUnknown.

Requisitos

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