IKsPropertySet::Set-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 Set -Methode legt eine Eigenschaft fest, die durch eine Eigenschaftensatz-GUID und eine Eigenschafts-ID identifiziert wird.
Syntax
HRESULT Set(
[in] REFGUID guidPropSet,
[in] DWORD dwPropID,
[in] LPVOID pInstanceData,
[in] DWORD cbInstanceData,
[in] LPVOID pPropData,
[in] DWORD cbPropData
);
Parameter
-
guidPropSet [in]
-
GUID des Eigenschaftensatzes.
-
dwPropID [in]
-
Bezeichner der Eigenschaft innerhalb des Eigenschaftssatzes.
-
pInstanceData [in]
-
Zeiger auf einen Puffer, der instance Daten für die Eigenschaft enthält.
-
cbInstanceData [in]
-
Größe des pInstanceData-Puffers in Bytes.
-
pPropData [in]
-
Zeiger auf einen Puffer, der den Wert der -Eigenschaft enthält.
-
cbPropData [in]
-
Sise des pPropData-Puffers in Bytes.
Rückgabewert
Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.
| Rückgabecode | Beschreibung |
|---|---|
|
Erfolg. |
|
Der Eigenschaftensatz wird nicht unterstützt. |
|
Die Eigenschafts-ID wird für den angegebenen Eigenschaftensatz nicht unterstützt. |
Bemerkungen
Hinweis
Eine weitere Schnittstelle mit diesem Namen ist in der Headerdatei dsound.h vorhanden. Die beiden Schnittstellen sind nicht kompatibel. Die IKsControl-Schnittstelle , die im DirectShow DDK dokumentiert ist, ist jetzt die empfohlene Schnittstelle zum Übergeben von Eigenschaftssätzen zwischen WDM-Treibern und Benutzermoduskomponenten.
Sie müssen Ks.h vor Ksproxy.h einschließen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
Siehe auch