Video Capture Minidriver-Eigenschaftensätze
In diesem Abschnitt werden die videoaufzeichnungsspezifischen Eigenschaftensätze beschrieben, die für Videoaufzeichnungs-Minidriver verfügbar sind, die WDM-Kernelstreamingdienste unter Microsoft Windows XP, Windows 2000, Windows 98/Me und höheren Betriebssystemen verwenden.
Die Verweisseite für jede Eigenschaft enthält eine Tabelle mit den folgenden Spaltenüberschriften.
| Herunterladen | Set | Ziel | Eigenschaftsdeskriptortyp | Eigenschaftswerttyp |
|---|---|---|---|---|
Diese Überschriften haben die folgende Bedeutung:
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 Anheften. (Die Eigenschaftsanforderung gibt das Zielobjekt anhand des Kernelhandles an.)
Eigenschaftsdeskriptortyp
Der Eigenschaftsdeskriptor gibt die Eigenschaft und den Vorgang an, der für diese Eigenschaft ausgeführt werden soll. Der Deskriptor beginnt immer mit einer KSPROPERTY-Struktur , aber einige Deskriptortypen enthalten zusätzliche Informationen. Beispielsweise ist die KSNODEPROPERTY-Struktur ein Eigenschaftendeskriptor, der mit einer KSPROPERTY-Struktur beginnt, aber auch einen Knotenbezeichner enthält.
Eigenschaftswerttyp
Eine Eigenschaft hat einen Wert, und der Typ dieses Werts hängt von der -Eigenschaft ab. Eine Eigenschaft, die sich beispielsweise in einem von nur zwei Zuständen befinden kann – on oder off -, weist in der Regel einen BOOL-Wert auf. 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.
Die obige Eigenschaftsbeschreibung und der Eigenschaftenwert sind die eigenschaftenspezifischen Versionen der instance-Spezifikations- und Vorgangsdatenpuffer, die KS-Eigenschaften, Ereignisse und Methoden erläutert.
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 Basic-Support-Vorgang für ihre Eigenschaften. Ob sie die Get - und Set-Vorgänge unterstützen, hängt von der -Eigenschaft ab. Eine Eigenschaft, die eine inhärente Funktion des Filter- oder Anheftobjekts darstellt, erfordert wahrscheinlich nur einen Get-Vorgang. Eine Eigenschaft, die eine konfigurierbare Einstellung darstellt, erfordert möglicherweise nur einen Set-Vorgang , obwohl ein Get-Vorgang auch zum Lesen der aktuellen Einstellung nützlich sein kann. Weitere Informationen zur Verwendung der Get-, Set- und Basic-Support-Vorgänge mit Videoaufzeichnungseigenschaften finden Sie unter KS-Eigenschaften.
Jede Eigenschaftenbeschreibung enthält eine Tabelle, die angibt, ob Videoaufnahme-Minidriver das Lesen oder Schreiben der Eigenschaft unterstützen müssen. Videoaufzeichnungsminidriver sollten STATUS_NOT_SUPPORTED zurückgeben, um Anforderungen für Eigenschaften zu erhalten oder festzulegen, die vom Minidriver nicht unterstützt werden.
In der folgenden Liste werden Kernelstreamingeigenschaftensätze beschrieben, die Videoaufzeichnungsminidriver verwenden:
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