Freigeben über


KSPROPERTY_CAMERACONTROL_EXTENDED_METADATA

Dieses erweiterte Eigenschaftensteuerelement wird vom Client verwendet, um den Treiber nach den Metadatenpufferanforderungen abzufragen. Es wird zusammen mit einer Standard-KSCAMERA_EXTENDEDPROP_HEADER-Struktur , gefolgt von einer KSCAMERA_EXTENDEDPROP_METADATAINFO-Struktur , an den Treiber gesendet.

Tabelle "Nutzungszusammenfassung"

`Scope` Control type

Version 1

Pin

Synchron

Im Folgenden finden Sie Metadatenflags, die im KSCAMERA_EXTENDEDPROP_HEADER platziert werden können . Flags-Feld .

#define KSCAMERA_EXTENDEDPROP_METADATA_SYSTEMMEMORY                     0x0000000000000001  
#define KSCAMERA_EXTENDEDPROP_METADATA_ALIGNMENTREQUIRED                0x0000000000000100

In einem Get-Aufruf führt der Treiber folgendes aus:

  1. Füllt KSCAMERA_EXTENDEDPROP_HEADER aus. Funktion mit 0.

  2. Füllen Sie KSCAMERA_EXTENDEDPROP_HEADER aus. Flags mit einer Kombination aus einem der oben genannten KSCAMERA_EXTENDEDPROP_METADATA_XXX-Flags , um die Metadatenspeicheranforderungen anzugeben.

  3. Füllen Sie KSCAMERA_EXTENDEDPROP_METADATAINFO aus. BufferAlignment mit der gewünschten Speicherausrichtung (KSCAMERA_EXTENDEDPROP_MetadataAlignment_Xxx). Mögliche Werte finden Sie im KSCAMERA_EXTENDEDPROP_MetadataAlignment .

  4. Füllen Sie KSCAMERA_EXTENDEDPROP_METADATAINFO aus. MaxMetadataBufferSize mit der erforderlichen Metadatenpuffergröße in Bytes.

Die folgende Tabelle enthält die Beschreibungen und Anforderungen für die KSCAMERA_EXTENDEDPROP_HEADER Strukturfelder bei Verwendung des Metadatensteuerelements.

Member BESCHREIBUNG

Version

Dies muss 1 sein.

PinId

Dies muss die Pin-ID sein, die dem Pin zugeordnet ist, dessen Frame Metadaten enthält. Dies kann eine beliebige Vorschau-, Datensatz- und Bildnadel sein.

Size

Dies muss sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof(KSCAMERA_EXTENDEDPROP_METADATAINFO) sein,

Ergebnis

Dies gibt die Fehlerergebnisse des letzten SET-Vorgangs an. Wenn kein SET-Vorgang stattgefunden hat, muss dieser 0 sein.

Funktion

Dies ist nicht verwendet und muss 0 sein.

Flags

Dies ist ein Lese-/Schreibfeld. Dies kann eine beliebige Kombination aus KSCAMERA_EXTENDEDPROP_METADATA_ALIGNMENTREQUIRED oder KSCAMERA_EXTENDEDPROP_METADATA_SYSTEMMEMORY sein.

Anforderungen

Header

Ksmedia.h