KSCAMERA_EXTENDEDPROP_HEADER Struktur (ksmedia.h)
Die KSCAMERA_EXTENDEDPROP_HEADER Struktur ist der Nutzlastheader für eine erweiterte Steuerelementeigenschaft.
Syntax
typedef struct tagKSCAMERA_EXTENDEDPROP_HEADER {
ULONG Version;
ULONG PinId;
ULONG Size;
ULONG Result;
ULONGLONG Flags;
ULONGLONG Capability;
} KSCAMERA_EXTENDEDPROP_HEADER, *PKSCAMERA_EXTENDEDPROP_HEADER;
Angehörige
Version
Die Versionsnummer der erweiterten Eigenschaft. Dies ist auf 1 festgelegt.
PinId
Die Pin-ID, die der Eigenschaft entspricht. Wenn PinId- auf (ULONG)-1 festgelegt ist, gilt das Steuerelement für den Filter. Andernfalls muss der Kameratreiber dieses Steuerelement an den entsprechenden Pin weiterleiten, wenn dieser Pin erstellt wird (oder falls bereits verfügbar).
Size
Die Gesamtgröße in Byte der gesamten Nutzlast. Dazu gehören die KSCAMERA_EXTENDEDPROP_HEADER Struktur und die folgenden Steuerelement-spezifischen Nutzlastdaten.
Result
Bei einem Set-Vorgang ist dies 0. Bei Abfragen enthält Ergebnis- fehlercode, den der Treiber für den letzten Steuerungsvorgang bereitstellt.
Flags
Die Einstellungen in Flags können je nach Steuerelement variieren.
Das Bit mit hoher Reihenfolge des Flags Werts ist reserviert. Dieses Bit dient als Abbruchkennzeichnung und wird als KSCAMERA_EXTENDEDPROP_FLAG_CANCELOPERATIONdefiniert. Dieses Kennzeichen ist nur für asynchrone Steuerelemente aussagekräftig.
Capability
Dieses Element ist schreibgeschützt und gibt die Standardfunktionen des Steuerelements an.
Die folgenden Funktionen sind definiert.
| Wert | Beschreibung |
|---|---|
| KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL | Das Steuerelement unterstützt asynchronen Vorgang. |
| KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE | Gilt nur für asynchrone Steuerelemente. Dieses Kennzeichen kennzeichnet den Steuerelementvorgang als abbruchfähig. Wenn ein synchrones Steuerelement dieses Kennzeichen festlegt, wird es als ungültig gekennzeichnet und wird nicht für Anwendungen höherer Ebene verfügbar gemacht. |
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8.1 |
| mindestens unterstützte Server- | Windows Server 2012 R2 |
| Header- | ksmedia.h (enthalten Ksmedia.h) |