Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In diesem Abschnitt werden die videoaufnahmespezifischen Eigenschaftensätze beschrieben, die für Videoaufnahme-Minidriver verfügbar sind, die WDM-Kernelstreamingdienste in Microsoft Windows XP, Windows 2000 und Windows 98/Me und höher verwenden.
Die Referenzseite für jede Eigenschaft enthält eine Tabelle mit den folgenden Spaltenüberschriften.
| Get | Set | Target | Eigenschaftendeskriptortyp | Eigenschaftswerttyp |
|---|---|---|---|---|
Diese Überschriften haben die folgenden Bedeutungen:
Get
Unterstützt das KS-Zielobjekt die KSPROPERTY_TYPE_GET Eigenschaftsanforderung?
Set
Unterstützt das KS-Zielobjekt die KSPROPERTY_TYPE_SET Eigenschaftsanforderung?
Target
Das Ziel ist das KS-Objekt, an das die Eigenschaftsanforderung gesendet wird. Das Ziel für eine Videoaufnahmeeigenschaft ist entweder ein Filter oder ein Pin. (Die Eigenschaftsanforderung gibt das Zielobjekt anhand des Kernelhandles an.)
Eigenschaftendeskriptortyp
Der Eigenschaftsdeskriptor gibt die Eigenschaft und den Vorgang an, der für diese Eigenschaft ausgeführt werden soll. The descriptor always begins with a KSPROPERTY structure, but some types of descriptor contain additional information. For example, the KSNODEPROPERTY structure is a property descriptor that begins with a KSPROPERTY structure but also includes a node identifier.
Eigenschaftswerttyp
Eine Eigenschaft hat einen Wert, und der Typ dieses Werts hängt von der Eigenschaft ab. Beispielsweise hat eine Eigenschaft, die sich in einem von nur zwei Zuständen befinden kann –-ein- oder aus- in der Regel einen BOOL-Wert. Eine Eigenschaft, die ganzzahlige Werte von 0x0 bis 0xFFFFFFFF annehmen kann, kann einen ULONG-Wert aufweisen. Komplexere Eigenschaften können Werte aufweisen, die Arrays oder Strukturen sind.
Der obige Eigenschaftsdeskriptor und der Eigenschaftswert sind die eigenschaftsspezifischen Versionen der Instanzenspezifikations- und Vorgangsdatenpuffer, die von KS-Eigenschaften, Ereignissen und Methoden erläutert werden.
Eine Eigenschaftsanforderung verwendet eines der folgenden Flags, um den Vorgang anzugeben, der für die Eigenschaft ausgeführt werden soll:
KSPROPERTY_TYPE_BASICSUPPORT
KSPROPERTY_TYPE_GET
KSPROPERTY_TYPE_SET
Alle Filter- und Pinobjekte unterstützen den grundlegenden Supportvorgang für ihre Eigenschaften. Whether they support the get and Set operations depends on the property. Eine Eigenschaft, die eine inhärente Funktion des Filter- oder Pinobjekts darstellt, erfordert wahrscheinlich nur einen Get-Vorgang. A property that represents a configurable setting might require only a Set operation, although a get operation might also be useful for reading the current setting. For more information about using the get, set, and basic-support operations with video capture properties, see KS Properties.
Jede Eigenschaftsbeschreibung enthält eine Tabelle, die angibt, ob Minidriver für die Videoaufnahme das Lesen oder Schreiben der Eigenschaft unterstützen müssen. Minidriver für die Videoaufnahme sollten STATUS_NOT_SUPPORTED als Reaktion auf das Abrufen oder Festlegen von Anforderungen für Eigenschaften zurückgeben, die vom Minidriver nicht unterstützt werden.
In der folgenden Liste werden Kernelstreaming-Eigenschaftensätze beschrieben, die von Minidrivern für die Videoaufnahme verwendet werden:
PROPSETID_VIDCAP_CAMERACONTROL
KSPROPERTYSETID_ExtendedCameraControl
PROPSETID_VIDCAP_DROPPEDFRAMES
PROPSETID_VIDCAP_VIDEOCOMPRESSION
Die folgenden Eigenschaftensätze können mit dem USB-Videoklassentreiber verwendet werden:
PROPSETID_VIDCAP_CAMERACONTROL