Eigenschaftensätze (DirectShow)

  • Artikel

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Microsoft DirectShow verwendet Eigenschaftensätze, um erweiterte Dienste zu unterstützen, die von Hardware und den zugehörigen Treibern und Filtern angeboten werden. Hardware- und Filterhersteller können neue Funktionen als Eigenschaften definieren, sie in Eigenschaftensätzen anordnen und die Spezifikation für diese Eigenschaftensätze veröffentlichen. Als Anwendungsentwickler können Sie die Methoden der IKsPropertySet-Schnittstelle verwenden, um zu bestimmen, ob ein Treiber oder Filter einen bestimmten Satz von Eigenschaften unterstützt, und diese Eigenschaften abrufen oder festlegen.

Alle methoden, die von IKsPropertySet verfügbar gemacht werden, erfordern eine GUID , die den Eigenschaftssatz (den guidPropSet-Parameter ) identifiziert, und ein DWORD , das die Eigenschaft innerhalb des Eigenschaftensatzes identifiziert (der dwPropID-Parameter ). Der dwPropID-Parameter ist in der Regel ein Member eines enumerierten Datentyps.

Einzelne Eigenschaften können über zugeordnete Daten verfügen, die Sie im pPropData-Parameter in den Methoden IKsPropertySet::Set und IKsPropertySet::Get angeben. In diesen Methoden werden die Eigenschaftendaten als Zeiger auf voideingegeben. Der Datentyp und die Bedeutung der Daten werden in der Definition des Eigenschaftensatzes angegeben.

Die folgenden Abschnitte enthalten Informationen zu den eigenschaftensätzen, die in DirectShow unterstützt werden: