Share via


FaceRectInfo 構造体 (mfapi.h)

FaceRectInfo 構造体は、MF_CAPTURE_METADATA_FACEROIS属性の BLOB 形式を表します。

構文

typedef struct tagFaceRectInfo {
  RECT Region;
  LONG confidenceLevel;
} FaceRectInfo;

メンバー

Region

顔検出が実行されているフレームの相対座標 (Q31 形式)。

confidenceLevel

顔である領域の信頼度 (0 - 100)。

解説

MF_CAPTURE_METADATA_FACEROIS属性には、ドライバーによって検出された顔の四角形の情報が含まれています。 既定では、driver\MFT0 はプレビュー ストリームの顔情報を提供する必要があります。 ドライバーが他のストリームで機能をアドバタイズする場合、アプリケーションがそれらのストリームで顔検出を有効にする場合、driver\MFT は対応するストリームに顔情報を提供する必要があります。 ドライバーでビデオ安定化が有効になっている場合は、ビデオ安定化後に顔情報を提供する必要があります。 支配する顔は、BLOB 内の最初の FaceRectInfo である必要があります。

FaceRectInfoBlobHeader および FaceRectInfo 構造体は、MF_CAPTURE_METADATA_FACEROIS属性の BLOB 形式のみを記述します。 face ROIs (KSCAMERA_METADATA_ITEMHEADER + face ROIs メタデータ ペイロード) のメタデータ項目の構造はドライバーに対して行われ、8 バイトのアラインが必要です。

必要条件

   
Header mfapi.h