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 を含む) |