CBasePropertyPage.SetObjects-Methode

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die SetObjects -Methode stellt IUnknown-Zeiger für die Objekte bereit, die der Eigenschaftenseite zugeordnet sind. Diese Methode implementiert die IPropertyPage::SetObjects-Methode .

Syntax

HRESULT SetObjects(
   ULONG     cObjects,
   LPUNKNOWN *ppUnk
);

Parameter

cObjects

Gibt die Anzahl der IUnknown-Zeiger in dem von ppUnk angegebenen Array an.

ppUnk

Gibt ein Array von IUnknown-Zeigern an.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Bemerkungen

Obwohl ppUnk ein Array von IUnknown-Zeigern angibt, ist die CBasePropertyPage-Klasse nur so konzipiert, dass sie nur ein zugeordnetes Objekt unterstützt. Wenn cObjects größer als 1 ist, gibt die Methode E_UNEXPECTED zurück.

Wenn cObjects gleich 1 ist, ruft diese Methode die CBasePropertyPage::OnConnect-Methode auf. Wenn cObjects gleich 0 ist, ruft diese Methode die CBasePropertyPage::OnDisconnect-Methode auf. Die abgeleitete Klasse sollte beide Methoden außer Kraft setzen. Ausführliche Informationen finden Sie in den Anmerkungen zu diesen Methoden.

Anforderungen

Siehe auch

CBasePropertyPage-Klasse