Método CBasePropertyPage.SetObjects

  • Artículo

[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 SetObjects método proporciona punteros IUnknown para los objetos asociados a la página de propiedades. Este método implementa el método IPropertyPage::SetObjects .

Sintaxis

HRESULT SetObjects(
   ULONG     cObjects,
   LPUNKNOWN *ppUnk
);

Parámetros

cObjects

Especifica el número de punteros IUnknown de la matriz especificada por ppUnk.

ppUnk

Especifica una matriz de punteros IUnknown .

Valor devuelto

Devuelve un valor HRESULT . Estos son algunos de los valores posibles.

Código devuelto Descripción
S_OK
 Correcto.
E_POINTER
 Argumento de puntero NULL.
E_UNEXPECTED
 Error inesperado.

Observaciones

Aunque ppUnk especifica una matriz de punteros IUnknown , la clase CBasePropertyPage solo está diseñada para admitir un objeto asociado. Si cObjects es mayor que 1, el método devuelve E_UNEXPECTED.

Si cObjects es igual a 1, este método llama al método CBasePropertyPage::OnConnect . Si cObjects es igual a 0, este método llama al método CBasePropertyPage::OnDisconnect . La clase derivada debe invalidar ambos métodos; para obtener más información, consulte los comentarios de esos métodos.

Requisitos

Requisito Value
Encabezado
Cprop.h (include Streams.h)
Biblioteca
Strmbase.lib (compilaciones comerciales);
Strmbasd.lib (compilaciones de depuración)

Consulte también

CBasePropertyPage (clase)