Win32 API 日本語リファレンス
ホーム › Devices.BiometricFramework › WINBIO_PRESENCE_PROPERTIES

WINBIO_PRESENCE_PROPERTIES

共用体
📘 Microsoft Learn (日本語) · English
サイズx64: 56 バイト / x86: 52 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールド型サイズx64x86説明
FacialFeatures_FacialFeatures_e__Struct32/24+0+0顔認証時の特徴プロパティを保持する内部構造体。
Iris_Iris_e__Struct52+0+0虹彩認証時の特徴プロパティを保持する内部構造体。

構造体: _FacialFeatures_e__Struct x64 32B / x86 24B

フィールド型サイズx64x86
BoundingBoxRECT16+0+0
DistanceINT4+16+16
OpaqueEngineData_OpaqueEngineData_e__Struct8/4+24+20

構造体: _Iris_e__Struct x64 52B / x86 52B

フィールド型サイズx64x86
EyeBoundingBox_1RECT16+0+0
EyeBoundingBox_2RECT16+16+16
PupilCenter_1POINT8+32+32
PupilCenter_2POINT8+40+40
DistanceINT4+48+48

公式ドキュメント

Windows 生体認証フレームワークが個人の存在を判定するために使用した生体認証値を含みます。

解説(Remarks)

FacialFeatures

Windows 生体認証フレームワークが個人の存在を判定するために使用した、顔の特徴の位置に関する値です。

BoundingBox

カメラ フレーム内における個人の顔の位置(ピクセル単位)です。この位置のピクセル数の上限は、カメラ フレームのサイズによって決まります。カメラ フレームのサイズを確認するには、WINBIO_PROPERTY_EXTENDED_SENSOR_INFO プロパティを取得します。プレゼンス モニターを使用するクライアントは、この位置をカメラ フレームにマッピングするためのスケーリング操作を実行する必要があります。

Distance

顔の実際の位置と、顔にとって理想的な焦点距離との間の距離です。この値の範囲は -100 から 100 です。0 は理想的な距離を示し、正の値は顔の実際の位置が遠すぎることを、負の値は実際の位置が近すぎることを示します。

Iris

Windows 生体認証フレームワークが個人の存在を判定するために使用した、虹彩の位置に関する値です。

EyeBoundingBox_1

登録対象の個人のいずれか一方の虹彩の、カメラ フレーム内における位置(ピクセル単位)です。虹彩認識システムが片方の目のみを監視している場合、この位置はその目の虹彩の位置です。虹彩認識システムが両目を監視していて、片方の目だけがカメラ フレーム内にある場合、この位置はカメラ フレーム内にある目の虹彩の位置です。虹彩認識システムが両目を監視していて、両目ともカメラ フレーム内にある場合、この位置はおそらくその個人の右目の虹彩の位置です。

この位置のピクセル数の上限は、カメラ フレームのサイズによって決まります。カメラ フレームのサイズを確認するには、WINBIO_PROPERTY_EXTENDED_SENSOR_INFO プロパティを取得します。プレゼンス モニターを使用するクライアントは、この位置をカメラ フレームにマッピングするためのスケーリング操作を実行する必要があります。

EyeBoundingBox_2

登録対象の個人のいずれか一方の虹彩の、カメラ フレーム内における位置(ピクセル単位)です。虹彩認識システムが片方の目のみを監視している場合、または片方の目だけがカメラ フレーム内にある場合、この値は空になります。虹彩認識システムが両目を監視していて、両目ともカメラ フレーム内にある場合、この位置はおそらくその個人の左目の虹彩の位置です。

この位置のピクセル数の上限は、カメラ フレームのサイズによって決まります。カメラ フレームのサイズを確認するには、WINBIO_PROPERTY_EXTENDED_SENSOR_INFO プロパティを取得します。プレゼンス モニターを使用するクライアントは、この位置をカメラ フレームにマッピングするためのスケーリング操作を実行する必要があります。

PupilCenter_1

登録対象の個人のいずれか一方の瞳孔の中心の位置です。虹彩認識システムが片方の目のみを監視している場合、この位置はその目の瞳孔の中心の位置です。虹彩認識システムが両目を監視していて、片方の目だけがカメラ フレーム内にある場合、この位置はカメラ フレーム内にある目の瞳孔の中心の位置です。虹彩認識システムが両目を監視していて、両目ともカメラ フレーム内にある場合、この位置はおそらくその個人の右目の瞳孔の中心の位置です。

PupilCenter_2

登録対象の個人のいずれか一方の瞳孔の中心の位置です。虹彩認識システムが片方の目のみを監視している場合、または片方の目だけがカメラ フレーム内にある場合、この値は空になります。虹彩認識システムが両目を監視していて、両目ともカメラ フレーム内にある場合、この位置はおそらくその個人の左目の瞳孔の中心の位置です。

Distance

虹彩の実際の位置と、虹彩にとって理想的な焦点距離との間の距離です。この値の範囲は -100 から 100 です。0 は理想的な距離を示し、正の値は虹彩の実際の位置が遠すぎることを、負の値は実際の位置が近すぎることを示します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp)

各言語での定義

#include <windows.h>

// WINBIO_PRESENCE_PROPERTIES  (x64 56 / x86 52 バイト)
typedef struct WINBIO_PRESENCE_PROPERTIES {
    _FacialFeatures_e__Struct FacialFeatures;
    _Iris_e__Struct Iris;
} WINBIO_PRESENCE_PROPERTIES;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct WINBIO_PRESENCE_PROPERTIES
{
    public _FacialFeatures_e__Struct FacialFeatures;
    public _Iris_e__Struct Iris;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure WINBIO_PRESENCE_PROPERTIES
    Public FacialFeatures As _FacialFeatures_e__Struct
    Public Iris As _Iris_e__Struct
End Structure
import ctypes
from ctypes import wintypes

class WINBIO_PRESENCE_PROPERTIES(ctypes.Structure):
    _fields_ = [
        ("FacialFeatures", _FacialFeatures_e__Struct),
        ("Iris", _Iris_e__Struct),
    ]
#[repr(C)]
pub struct WINBIO_PRESENCE_PROPERTIES {
    pub FacialFeatures: _FacialFeatures_e__Struct,
    pub Iris: _Iris_e__Struct,
}
import "golang.org/x/sys/windows"

type WINBIO_PRESENCE_PROPERTIES struct {
	FacialFeatures _FacialFeatures_e__Struct
	Iris _Iris_e__Struct
}
type
  WINBIO_PRESENCE_PROPERTIES = record
    FacialFeatures: _FacialFeatures_e__Struct;
    Iris: _Iris_e__Struct;
  end;
const WINBIO_PRESENCE_PROPERTIES = extern struct {
    FacialFeatures: _FacialFeatures_e__Struct,
    Iris: _Iris_e__Struct,
};
type
  WINBIO_PRESENCE_PROPERTIES {.bycopy.} = object
    FacialFeatures: _FacialFeatures_e__Struct
    Iris: _Iris_e__Struct
struct WINBIO_PRESENCE_PROPERTIES
{
    _FacialFeatures_e__Struct FacialFeatures;
    _Iris_e__Struct Iris;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; WINBIO_PRESENCE_PROPERTIES サイズ: 52 バイト(x86)
dim st, 13    ; 4byte整数×13(構造体サイズ 52 / 4 切り上げ)
; FacialFeatures : _FacialFeatures_e__Struct (+0, 24byte)  varptr(st)+0 を基点に操作(24byte:入れ子/配列)
; Iris : _Iris_e__Struct (+0, 52byte)  varptr(st)+0 を基点に操作(52byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; WINBIO_PRESENCE_PROPERTIES サイズ: 56 バイト(x64)
dim st, 14    ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; FacialFeatures : _FacialFeatures_e__Struct (+0, 32byte)  varptr(st)+0 を基点に操作(32byte:入れ子/配列)
; Iris : _Iris_e__Struct (+0, 52byte)  varptr(st)+0 を基点に操作(52byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global WINBIO_PRESENCE_PROPERTIES
    #field _FacialFeatures_e__Struct FacialFeatures
    #field _Iris_e__Struct Iris
#endstruct

stdim st, WINBIO_PRESENCE_PROPERTIES        ; NSTRUCT 変数を確保