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;
Member
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 wenn bereits verfügbar).
Size
Die Gesamtgröße in Bytes der gesamten Nutzlast. Dies umfasst die KSCAMERA_EXTENDEDPROP_HEADER-Struktur und die folgenden steuerungsspezifischen Nutzlastdaten.
Result
Bei einem Setvorgang ist dies 0. Für Abfragen enthält Result jeden Fehlercode, den der Treiber für den neuesten Steuerungsvorgang bereitstellt.
Flags
Die Einstellungen in Flags können je nach Steuerelement variieren.
Das High-Order-Bit des Flags-Werts ist reserviert. Dieses Bit dient als Abbruchflag und wird als KSCAMERA_EXTENDEDPROP_FLAG_CANCELOPERATION definiert. Dieses Flag ist nur für asynchrone Steuerelemente sinnvoll.
Capability
Dieser Member ist schreibgeschützt und gibt die Standardfunktionen des Steuerelements an.
Die folgenden Funktionen werden definiert.
| Wert | BESCHREIBUNG |
|---|---|
| KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL | Das Steuerelement unterstützt asynchrone Vorgänge. |
| KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE | Gilt nur für asynchrone Steuerelemente. Dieses Flag kennzeichnet den Steuerungsvorgang als abbruchfähig. Wenn ein synchrones Steuerelement dieses Flag festlegt, wird es als ungültig gekennzeichnet und wird nicht für Anwendungen auf höherer Ebene verfügbar gemacht. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8.1 |
| Unterstützte Mindestversion (Server) | Windows Server 2012 R2 |
| Kopfzeile | ksmedia.h (include Ksmedia.h) |