Método CBasePropertyPage.SetObjects

  • 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 SetObjects método fornece ponteiros IUnknown para os objetos associados à página de propriedades. Esse método implementa o método IPropertyPage::SetObjects .

Sintaxe

HRESULT SetObjects(
   ULONG     cObjects,
   LPUNKNOWN *ppUnk
);

Parâmetros

Cobjects

Especifica o número de ponteiros IUnknown na matriz especificada por ppUnk.

ppUnk

Especifica uma matriz de ponteiros IUnknown .

Retornar valor

Retorna um valor HRESULT . Os possíveis valores incluem os seguintes.

Código de retorno Descrição
S_OK
 Êxito.
E_POINTER
 Argumento de ponteiro NULL.
E_UNEXPECTED
 Falha inesperada.

Comentários

Embora ppUnk especifique uma matriz de ponteiros IUnknown , a classe CBasePropertyPage foi projetada apenas para dar suporte a um objeto associado. Se cObjects for maior que 1, o método retornará E_UNEXPECTED.

Se cObjects for igual a 1, esse método chamará o método CBasePropertyPage::OnConnect . Se cObjects for igual a 0, esse método chamará o método CBasePropertyPage::OnDisconnect . A classe derivada deve substituir ambos os métodos; para obter detalhes, consulte as observações para esses métodos.

Requisitos

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

Confira também

Classe CBasePropertyPage