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 です。 クエリの場合、 Result には、ドライバーが最新の制御操作に対して提供するエラー コードが含まれます。

Flags

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

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

Capability

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

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

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

要件

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

こちらもご覧ください

KSCAMERA_EXTENDEDPROP_VALUE