Freigeben über

Eigenschaftensätze (DirectShow)

  • Artikel

[Das dieser Seite zugeordnete Feature DirectShow-ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngineund Audio/Video Capture in Media Foundationersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code MediaPlayer-, IMFMediaEngine und Audio-/Videoaufnahme in Media Foundation anstelle von DirectShow-verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, um die neuen APIs zu verwenden, falls möglich umgeschrieben 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 Filteranbieter können neue Funktionen als Eigenschaften definieren, in Eigenschaftensätzen anordnen und die Spezifikation für diese Eigenschaftensätze veröffentlichen. Als Anwendungsentwickler können Sie die Methoden des 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 Eigenschaftensatz identifiziert (der guidPropSet Parameter) und eine DWORD-, die die Eigenschaft innerhalb des Eigenschaftensatzes identifiziert (der dwPropID Parameter). Der dwPropID--Parameter ist in der Regel ein Element eines aufgezählten Datentyps.

Einzelne Eigenschaften können daten zugeordnet haben, die Sie im parameter pPropData im IKsPropertySet::Set und IKsPropertySet::Get Methoden angeben. In diesen Methoden werden die Eigenschaftsdaten 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 in DirectShow unterstützten Eigenschaftensätzen: