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.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Erfolg. |
|
NULL-Zeigerargument. |
|
Unerwarteter Fehler. |
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
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|