KSCAMERA_PROFILE_INFO構造体 (ksmedia.h)

KSCAMERA_PROFILE_INFO構造体は、特定のプロファイルを一意に識別するために使用されます。

構文

typedef struct _KSCAMERA_PROFILE_INFO {
  GUID                      ProfileId;
  UINT32                    Index;
  UINT32                    PinCount;
  PKSCAMERA_PROFILE_PININFO Pins;
} KSCAMERA_PROFILE_INFO, *PKSCAMERA_PROFILE_INFO;

メンバー

ProfileId

プロファイルの一意の ID を表す GUID。 この GUID は、カスタム プロファイルを表す一意の IHV/OEM によって作成された GUID であるか、定義済みの GUID である場合があります。

このフィールドを KSCAMERAPROFILE_Legacyに設定することはできません。 レガシ プロファイルは、カメラ ドライバーによって公開することはできません。 アプリケーションがプロファイルをサポートできることを示していない場合、キャプチャ エンジンまたはメディア キャプチャの初期化中に、レガシ プロファイル ID がカメラ ドライバーに送信されます。

このような場合、カメラ ドライバーは動作をWindows 8.1モードの操作に戻し、対応するKSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_EXCLUSIVE_WITH_RECORDとKSPROPERTY_CAMERACONTROL_IMAGE_PIN_CAPABILITY_SEQUENCE_EXCLUSIVE_WITH_RECORDと共に、縮小されたセット メディアの種類のみを公開する必要があります。カメラドライバが、縮小された設定メディアタイプ内で同時記録/写真および/または記録/写真シーケンスをサポートできるかどうかを示す機能ビット。

Index

特定の ProfileId グループ内の各プロファイルには、一意の Index 値が必要です。 これにより、デバイスのプロファイルを ProfileId + Index で一意に識別できます。

PinCount

ピンが指すKSCAMERA_PROFILE_PININFO構造体の数。 この値は 0 より大きくする必要があります。

Pins

この プロファイルの各 ピンでサポートされているメディアの種類を定義するKSCAMERA_PROFILE_PININFO構造体の配列。 このフィールドは NULL にすることはできません。

要件

要件	値
Header	ksmedia.h (Ksmedia.h を含む)