KSCAMERA_EXTENDEDPROP_HEADER構造体 (ksmedia.h)

KSCAMERA_EXTENDEDPROP_HEADER 構造体は、拡張コントロール プロパティのペイロード ヘッダーです。

構文

typedef struct tagKSCAMERA_EXTENDEDPROP_HEADER {
  ULONG     Version;
  ULONG     PinId;
  ULONG     Size;
  ULONG     Result;
  ULONGLONG Flags;
  ULONGLONG Capability;
} KSCAMERA_EXTENDEDPROP_HEADER, *PKSCAMERA_EXTENDEDPROP_HEADER;

メンバーズ

Version

拡張プロパティのバージョン番号。 これは 1 に設定されます。

PinId

プロパティに対応するピン ID。 PinId が (ULONG)-1 に設定されている場合、コントロールはフィルターに適用されます。 それ以外の場合、カメラ ドライバーは、そのピンの作成時 (または既に使用可能な場合) に、対応するピンにこのコントロールをルーティングする必要があります。

Size

ペイロード全体の合計サイズ (バイト単位)。 これには、KSCAMERA_EXTENDEDPROP_HEADER 構造と、次のコントロール固有のペイロード データが含まれます。

Result

設定操作の場合、これは 0 です。 クエリの場合、結果 には、ドライバーが最新の制御操作に対して提供するエラー コードが含まれます。

Flags

Flags の設定は、コントロールによって異なる場合があります。

Flags 値の上位ビットが予約されています。 このビットはキャンセル フラグとして機能し、KSCAMERA_EXTENDEDPROP_FLAG_CANCELOPERATIONとして定義されます。 このフラグは、非同期コントロールでのみ意味があります。

Capability

このメンバーは読み取り専用であり、コントロールの標準機能を示します。

次の機能が定義されています。

価値	形容
KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL	このコントロールは非同期操作をサポートします。
KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE	非同期コントロールにのみ適用されます。 このフラグは、コントロール操作を取り消し可能としてマークします。 同期コントロールがこのフラグを設定すると、無効としてマークされ、上位レベルのアプリケーションには公開されません。

必要条件

要件	価値
サポートされる最小クライアント	Windows 8.1
サポートされる最小サーバー	Windows Server 2012 R2
ヘッダー	ksmedia.h (Ksmedia.h を含む)

関連項目

KSCAMERA_EXTENDEDPROP_VALUE