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

WINBIO_EXTENDED_ENGINE_INFO

構造体
サイズx64: 16 バイト / x86: 12 バイト

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

フィールド

フィールドサイズx64x86説明
GenericEngineCapabilitiesDWORD4+0+0エンジン共通の能力を示すビットフラグ。
FactorDWORD4+4+4エンジンが扱う生体要素の種別を示す値。
Specific_Specific_e__Union8/4+8+8生体要素種別に固有の追加エンジン情報を保持する無名共用体。

共用体: _Specific_e__Union x64 8B / x86 4B

フィールドサイズx64x86
NullDWORD4+0+0
FacialFeatures_FacialFeatures_e__Struct8/4+0+0
Fingerprint_Fingerprint_e__Struct8/4+0+0
Iris_Iris_e__Struct8/4+0+0
Voice_Voice_e__Struct8/4+0+0

公式ドキュメント

生体認証ユニットのエンジン アダプターの機能と登録要件に関する情報を格納します。

解説(Remarks)

GenericEngineCapabilities

特定の生体認証ユニットに接続されているエンジン コンポーネントの汎用的な機能です。

Factor

この構造体がエンジン アダプターの機能と登録要件に関する情報を格納する対象の生体認証ユニットの種類です。たとえば、Factor メンバーの値が WINBIO_TYPE_FINGERPRINT の場合、WINBIO_EXTENDED_ENGINE_INFO 構造体は指紋リーダーに適用され、関連する情報は Specifc.Fingerprint 構造体に格納されます。

Specific

特定の生体認証要素に関連する生体認証ユニットのエンジン アダプターの機能と登録要件に関する情報です。

Null

予約済みです。0 でなければなりません。

FacialFeatures

顔の特徴に関連する生体認証ユニットのエンジン アダプターの機能と登録要件に関する情報です。

Capabilities

予約済みです。0 でなければなりません。

EnrollmentRequirements

Null

予約済みです。0 でなければなりません。

Fingerprint

指紋パターンに関連する生体認証ユニットのエンジン アダプターの機能と登録要件に関する情報です。

Capabilities

予約済みです。0 でなければなりません。

EnrollmentRequirements

新しい指紋テンプレートを作成するために必要な良好なサンプルの数です。

GeneralSamples

新しい指紋テンプレートを作成するために必要な良好なサンプルの総数です。

Center

新しい指紋テンプレートを作成するために必要な、指紋の中央部分の良好なサンプルの数です。

TopEdge

新しい指紋テンプレートを作成するために必要な、指紋の上端部分の良好なサンプルの数です。

BottomEdge

新しい指紋テンプレートを作成するために必要な、指紋の下端部分の良好なサンプルの数です。

LeftEdge

新しい指紋テンプレートを作成するために必要な、指紋の左端部分の良好なサンプルの数です。

RightEdge

新しい指紋テンプレートを作成するために必要な、指紋の右端部分の良好なサンプルの数です。

Iris

虹彩パターンに関連する生体認証ユニットのエンジン アダプターの機能と登録要件に関する情報です。

Capabilities

予約済みです。0 でなければなりません。

EnrollmentRequirements

Null

予約済みです。0 でなければなりません。

Voice

音声パターンに関連する生体認証ユニットのエンジン アダプターの機能と登録要件に関する情報です。

Capabilities

予約済みです。0 でなければなりません。

EnrollmentRequirements

Null

予約済みです。0 でなければなりません。

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

各言語での定義

#include <windows.h>

// WINBIO_EXTENDED_ENGINE_INFO  (x64 16 / x86 12 バイト)
typedef struct WINBIO_EXTENDED_ENGINE_INFO {
    DWORD GenericEngineCapabilities;
    DWORD Factor;
    _Specific_e__Union Specific;
} WINBIO_EXTENDED_ENGINE_INFO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct WINBIO_EXTENDED_ENGINE_INFO
{
    public uint GenericEngineCapabilities;
    public uint Factor;
    public _Specific_e__Union Specific;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure WINBIO_EXTENDED_ENGINE_INFO
    Public GenericEngineCapabilities As UInteger
    Public Factor As UInteger
    Public Specific As _Specific_e__Union
End Structure
import ctypes
from ctypes import wintypes

class WINBIO_EXTENDED_ENGINE_INFO(ctypes.Structure):
    _fields_ = [
        ("GenericEngineCapabilities", wintypes.DWORD),
        ("Factor", wintypes.DWORD),
        ("Specific", _Specific_e__Union),
    ]
#[repr(C)]
pub struct WINBIO_EXTENDED_ENGINE_INFO {
    pub GenericEngineCapabilities: u32,
    pub Factor: u32,
    pub Specific: _Specific_e__Union,
}
import "golang.org/x/sys/windows"

type WINBIO_EXTENDED_ENGINE_INFO struct {
	GenericEngineCapabilities uint32
	Factor uint32
	Specific _Specific_e__Union
}
type
  WINBIO_EXTENDED_ENGINE_INFO = record
    GenericEngineCapabilities: DWORD;
    Factor: DWORD;
    Specific: _Specific_e__Union;
  end;
const WINBIO_EXTENDED_ENGINE_INFO = extern struct {
    GenericEngineCapabilities: u32,
    Factor: u32,
    Specific: _Specific_e__Union,
};
type
  WINBIO_EXTENDED_ENGINE_INFO {.bycopy.} = object
    GenericEngineCapabilities: uint32
    Factor: uint32
    Specific: _Specific_e__Union
struct WINBIO_EXTENDED_ENGINE_INFO
{
    uint GenericEngineCapabilities;
    uint Factor;
    _Specific_e__Union Specific;
}

HSP用 定義

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

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

stdim st, WINBIO_EXTENDED_ENGINE_INFO        ; NSTRUCT 変数を確保
st->GenericEngineCapabilities = 100
mes "GenericEngineCapabilities=" + st->GenericEngineCapabilities
; ※union フィールドは byte 列で確保(NSTRUCT は union 非対応)。必要に応じ手動でアクセス。