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)

Weitere Informationen

KSCAMERA_EXTENDEDPROP_VALUE