Metodo CBasePropertyPage.SetObjects

Articolo
07/28/2023

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il SetObjects metodo fornisce puntatori IUnknown per gli oggetti associati alla pagina delle proprietà. Questo metodo implementa il metodo IPropertyPage::SetObjects .

Sintassi

HRESULT SetObjects(
   ULONG     cObjects,
   LPUNKNOWN *ppUnk
);

Parametri

cObjects: Specifica il numero di puntatori IUnknown nella matrice specificata da ppUnk.
ppUnk: Specifica una matrice di puntatori IUnknown .

Valore restituito

Restituisce un valore HRESULT . Di seguito sono indicati alcuni valori possibili.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_POINTER	Argomento puntatore NULL.
E_UNEXPECTED	Errore imprevisto.

Commenti

Sebbene ppUnk specifichi una matrice di puntatori IUnknown , la classe CBasePropertyPage è progettata solo per supportare un oggetto associato. Se cObjects è maggiore di 1, il metodo restituisce E_UNEXPECTED.

Se cObjects è uguale a 1, questo metodo chiama il metodo CBasePropertyPage::OnConnect . Se cObjects è uguale a 0, questo metodo chiama il metodo CBasePropertyPage::OnDisconnect . La classe derivata deve eseguire l'override di entrambi i metodi; per informazioni dettagliate, vedere le osservazioni per tali metodi.

Requisiti

Requisito	Valore
Intestazione	Cprop.h (include Streams.h)
Libreria	Strmbase.lib (build retail); Strmbasd.lib (build di debug)

Vedi anche

Classe CBasePropertyPage

Condividi tramite