ホーム › Devices.BiometricFramework › WinBioControlUnit

WinBioControlUnit

関数

生体認証ユニットへ制御コマンドを送信し応答を受け取る。

DLLwinbio.dll呼出規約winapi対応OSWindows 7 以降

シグネチャ

// winbio.dll
#include <windows.h>

HRESULT WinBioControlUnit(
    DWORD SessionHandle,
    DWORD UnitId,
    WINBIO_COMPONENT Component,
    DWORD ControlCode,
    BYTE* SendBuffer,
    UINT_PTR SendBufferSize,
    BYTE* ReceiveBuffer,
    UINT_PTR ReceiveBufferSize,
    UINT_PTR* ReceiveDataSize,
    DWORD* OperationStatus   // optional
);

パラメーター

名前	型	方向	説明
SessionHandle	DWORD	in	ユニット制御に用いるセッションのハンドル。
UnitId	DWORD	in	制御コマンドを送る対象ユニットのID。
Component	WINBIO_COMPONENT	in	制御対象のユニット内コンポーネント(センサー/エンジン/ストレージ)を指定。
ControlCode	DWORD	in	ベンダー定義の制御コードを指定するDWORD値。
SendBuffer	BYTE*	in	コンポーネントへ送信するデータのバッファへのポインタ。不要時はNULL可。
SendBufferSize	UINT_PTR	in	SendBufferのバイトサイズ。
ReceiveBuffer	BYTE*	out	コンポーネントから受信するデータを格納するバッファへのポインタ。
ReceiveBufferSize	UINT_PTR	in	ReceiveBufferの確保済みバイトサイズ。
ReceiveDataSize	UINT_PTR*	inout	実際に受信したデータのバイト数を受け取る出力ポインタ。
OperationStatus	DWORD*	outoptional	コンポーネント固有の操作結果ステータスを受け取る出力ポインタ。

戻り値の型: HRESULT

各言語での呼び出し定義

// winbio.dll
#include <windows.h>

HRESULT WinBioControlUnit(
    DWORD SessionHandle,
    DWORD UnitId,
    WINBIO_COMPONENT Component,
    DWORD ControlCode,
    BYTE* SendBuffer,
    UINT_PTR SendBufferSize,
    BYTE* ReceiveBuffer,
    UINT_PTR ReceiveBufferSize,
    UINT_PTR* ReceiveDataSize,
    DWORD* OperationStatus   // optional
);

[DllImport("winbio.dll", ExactSpelling = true)]
static extern int WinBioControlUnit(
    uint SessionHandle,   // DWORD
    uint UnitId,   // DWORD
    uint Component,   // WINBIO_COMPONENT
    uint ControlCode,   // DWORD
    IntPtr SendBuffer,   // BYTE*
    UIntPtr SendBufferSize,   // UINT_PTR
    IntPtr ReceiveBuffer,   // BYTE* out
    UIntPtr ReceiveBufferSize,   // UINT_PTR
    ref UIntPtr ReceiveDataSize,   // UINT_PTR* in/out
    IntPtr OperationStatus   // DWORD* optional, out
);

<DllImport("winbio.dll", ExactSpelling:=True)>
Public Shared Function WinBioControlUnit(
    SessionHandle As UInteger,   ' DWORD
    UnitId As UInteger,   ' DWORD
    Component As UInteger,   ' WINBIO_COMPONENT
    ControlCode As UInteger,   ' DWORD
    SendBuffer As IntPtr,   ' BYTE*
    SendBufferSize As UIntPtr,   ' UINT_PTR
    ReceiveBuffer As IntPtr,   ' BYTE* out
    ReceiveBufferSize As UIntPtr,   ' UINT_PTR
    ByRef ReceiveDataSize As UIntPtr,   ' UINT_PTR* in/out
    OperationStatus As IntPtr   ' DWORD* optional, out
) As Integer
End Function

' SessionHandle : DWORD
' UnitId : DWORD
' Component : WINBIO_COMPONENT
' ControlCode : DWORD
' SendBuffer : BYTE*
' SendBufferSize : UINT_PTR
' ReceiveBuffer : BYTE* out
' ReceiveBufferSize : UINT_PTR
' ReceiveDataSize : UINT_PTR* in/out
' OperationStatus : DWORD* optional, out
Declare PtrSafe Function WinBioControlUnit Lib "winbio" ( _
    ByVal SessionHandle As Long, _
    ByVal UnitId As Long, _
    ByVal Component As Long, _
    ByVal ControlCode As Long, _
    ByVal SendBuffer As LongPtr, _
    ByVal SendBufferSize As LongPtr, _
    ByVal ReceiveBuffer As LongPtr, _
    ByVal ReceiveBufferSize As LongPtr, _
    ByRef ReceiveDataSize As LongPtr, _
    ByVal OperationStatus As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

WinBioControlUnit = ctypes.windll.winbio.WinBioControlUnit
WinBioControlUnit.restype = ctypes.c_int
WinBioControlUnit.argtypes = [
    wintypes.DWORD,  # SessionHandle : DWORD
    wintypes.DWORD,  # UnitId : DWORD
    wintypes.DWORD,  # Component : WINBIO_COMPONENT
    wintypes.DWORD,  # ControlCode : DWORD
    ctypes.POINTER(ctypes.c_ubyte),  # SendBuffer : BYTE*
    ctypes.c_size_t,  # SendBufferSize : UINT_PTR
    ctypes.POINTER(ctypes.c_ubyte),  # ReceiveBuffer : BYTE* out
    ctypes.c_size_t,  # ReceiveBufferSize : UINT_PTR
    ctypes.POINTER(ctypes.c_size_t),  # ReceiveDataSize : UINT_PTR* in/out
    ctypes.POINTER(wintypes.DWORD),  # OperationStatus : DWORD* optional, out
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('winbio.dll')
WinBioControlUnit = Fiddle::Function.new(
  lib['WinBioControlUnit'],
  [
    -Fiddle::TYPE_INT,  # SessionHandle : DWORD
    -Fiddle::TYPE_INT,  # UnitId : DWORD
    -Fiddle::TYPE_INT,  # Component : WINBIO_COMPONENT
    -Fiddle::TYPE_INT,  # ControlCode : DWORD
    Fiddle::TYPE_VOIDP,  # SendBuffer : BYTE*
    Fiddle::TYPE_UINTPTR_T,  # SendBufferSize : UINT_PTR
    Fiddle::TYPE_VOIDP,  # ReceiveBuffer : BYTE* out
    Fiddle::TYPE_UINTPTR_T,  # ReceiveBufferSize : UINT_PTR
    Fiddle::TYPE_VOIDP,  # ReceiveDataSize : UINT_PTR* in/out
    Fiddle::TYPE_VOIDP,  # OperationStatus : DWORD* optional, out
  ],
  Fiddle::TYPE_INT)

#[link(name = "winbio")]
extern "system" {
    fn WinBioControlUnit(
        SessionHandle: u32,  // DWORD
        UnitId: u32,  // DWORD
        Component: u32,  // WINBIO_COMPONENT
        ControlCode: u32,  // DWORD
        SendBuffer: *mut u8,  // BYTE*
        SendBufferSize: usize,  // UINT_PTR
        ReceiveBuffer: *mut u8,  // BYTE* out
        ReceiveBufferSize: usize,  // UINT_PTR
        ReceiveDataSize: *mut usize,  // UINT_PTR* in/out
        OperationStatus: *mut u32  // DWORD* optional, out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("winbio.dll")]
public static extern int WinBioControlUnit(uint SessionHandle, uint UnitId, uint Component, uint ControlCode, IntPtr SendBuffer, UIntPtr SendBufferSize, IntPtr ReceiveBuffer, UIntPtr ReceiveBufferSize, ref UIntPtr ReceiveDataSize, IntPtr OperationStatus);
"@
$api = Add-Type -MemberDefinition $sig -Name 'winbio_WinBioControlUnit' -Namespace Win32 -PassThru
# $api::WinBioControlUnit(SessionHandle, UnitId, Component, ControlCode, SendBuffer, SendBufferSize, ReceiveBuffer, ReceiveBufferSize, ReceiveDataSize, OperationStatus)

#uselib "winbio.dll"
#func global WinBioControlUnit "WinBioControlUnit" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; WinBioControlUnit SessionHandle, UnitId, Component, ControlCode, varptr(SendBuffer), SendBufferSize, varptr(ReceiveBuffer), ReceiveBufferSize, varptr(ReceiveDataSize), varptr(OperationStatus)   ; 戻り値は stat
; SessionHandle : DWORD -> "sptr"
; UnitId : DWORD -> "sptr"
; Component : WINBIO_COMPONENT -> "sptr"
; ControlCode : DWORD -> "sptr"
; SendBuffer : BYTE* -> "sptr"
; SendBufferSize : UINT_PTR -> "sptr"
; ReceiveBuffer : BYTE* out -> "sptr"
; ReceiveBufferSize : UINT_PTR -> "sptr"
; ReceiveDataSize : UINT_PTR* in/out -> "sptr"
; OperationStatus : DWORD* optional, out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "winbio.dll"
#cfunc global WinBioControlUnit "WinBioControlUnit" int, int, int, int, var, sptr, var, sptr, var, var
; res = WinBioControlUnit(SessionHandle, UnitId, Component, ControlCode, SendBuffer, SendBufferSize, ReceiveBuffer, ReceiveBufferSize, ReceiveDataSize, OperationStatus)
; SessionHandle : DWORD -> "int"
; UnitId : DWORD -> "int"
; Component : WINBIO_COMPONENT -> "int"
; ControlCode : DWORD -> "int"
; SendBuffer : BYTE* -> "var"
; SendBufferSize : UINT_PTR -> "sptr"
; ReceiveBuffer : BYTE* out -> "var"
; ReceiveBufferSize : UINT_PTR -> "sptr"
; ReceiveDataSize : UINT_PTR* in/out -> "var"
; OperationStatus : DWORD* optional, out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "winbio.dll"
#cfunc global WinBioControlUnit "WinBioControlUnit" int, int, int, int, sptr, sptr, sptr, sptr, sptr, sptr
; res = WinBioControlUnit(SessionHandle, UnitId, Component, ControlCode, varptr(SendBuffer), SendBufferSize, varptr(ReceiveBuffer), ReceiveBufferSize, varptr(ReceiveDataSize), varptr(OperationStatus))
; SessionHandle : DWORD -> "int"
; UnitId : DWORD -> "int"
; Component : WINBIO_COMPONENT -> "int"
; ControlCode : DWORD -> "int"
; SendBuffer : BYTE* -> "sptr"
; SendBufferSize : UINT_PTR -> "sptr"
; ReceiveBuffer : BYTE* out -> "sptr"
; ReceiveBufferSize : UINT_PTR -> "sptr"
; ReceiveDataSize : UINT_PTR* in/out -> "sptr"
; OperationStatus : DWORD* optional, out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。

出力引数:

; HRESULT WinBioControlUnit(DWORD SessionHandle, DWORD UnitId, WINBIO_COMPONENT Component, DWORD ControlCode, BYTE* SendBuffer, UINT_PTR SendBufferSize, BYTE* ReceiveBuffer, UINT_PTR ReceiveBufferSize, UINT_PTR* ReceiveDataSize, DWORD* OperationStatus)
#uselib "winbio.dll"
#cfunc global WinBioControlUnit "WinBioControlUnit" int, int, int, int, var, intptr, var, intptr, var, var
; res = WinBioControlUnit(SessionHandle, UnitId, Component, ControlCode, SendBuffer, SendBufferSize, ReceiveBuffer, ReceiveBufferSize, ReceiveDataSize, OperationStatus)
; SessionHandle : DWORD -> "int"
; UnitId : DWORD -> "int"
; Component : WINBIO_COMPONENT -> "int"
; ControlCode : DWORD -> "int"
; SendBuffer : BYTE* -> "var"
; SendBufferSize : UINT_PTR -> "intptr"
; ReceiveBuffer : BYTE* out -> "var"
; ReceiveBufferSize : UINT_PTR -> "intptr"
; ReceiveDataSize : UINT_PTR* in/out -> "var"
; OperationStatus : DWORD* optional, out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; HRESULT WinBioControlUnit(DWORD SessionHandle, DWORD UnitId, WINBIO_COMPONENT Component, DWORD ControlCode, BYTE* SendBuffer, UINT_PTR SendBufferSize, BYTE* ReceiveBuffer, UINT_PTR ReceiveBufferSize, UINT_PTR* ReceiveDataSize, DWORD* OperationStatus)
#uselib "winbio.dll"
#cfunc global WinBioControlUnit "WinBioControlUnit" int, int, int, int, intptr, intptr, intptr, intptr, intptr, intptr
; res = WinBioControlUnit(SessionHandle, UnitId, Component, ControlCode, varptr(SendBuffer), SendBufferSize, varptr(ReceiveBuffer), ReceiveBufferSize, varptr(ReceiveDataSize), varptr(OperationStatus))
; SessionHandle : DWORD -> "int"
; UnitId : DWORD -> "int"
; Component : WINBIO_COMPONENT -> "int"
; ControlCode : DWORD -> "int"
; SendBuffer : BYTE* -> "intptr"
; SendBufferSize : UINT_PTR -> "intptr"
; ReceiveBuffer : BYTE* out -> "intptr"
; ReceiveBufferSize : UINT_PTR -> "intptr"
; ReceiveDataSize : UINT_PTR* in/out -> "intptr"
; OperationStatus : DWORD* optional, out -> "intptr"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	winbio = windows.NewLazySystemDLL("winbio.dll")
	procWinBioControlUnit = winbio.NewProc("WinBioControlUnit")
)

// SessionHandle (DWORD), UnitId (DWORD), Component (WINBIO_COMPONENT), ControlCode (DWORD), SendBuffer (BYTE*), SendBufferSize (UINT_PTR), ReceiveBuffer (BYTE* out), ReceiveBufferSize (UINT_PTR), ReceiveDataSize (UINT_PTR* in/out), OperationStatus (DWORD* optional, out)
r1, _, err := procWinBioControlUnit.Call(
	uintptr(SessionHandle),
	uintptr(UnitId),
	uintptr(Component),
	uintptr(ControlCode),
	uintptr(SendBuffer),
	uintptr(SendBufferSize),
	uintptr(ReceiveBuffer),
	uintptr(ReceiveBufferSize),
	uintptr(ReceiveDataSize),
	uintptr(OperationStatus),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // HRESULT

function WinBioControlUnit(
  SessionHandle: DWORD;   // DWORD
  UnitId: DWORD;   // DWORD
  Component: DWORD;   // WINBIO_COMPONENT
  ControlCode: DWORD;   // DWORD
  SendBuffer: Pointer;   // BYTE*
  SendBufferSize: NativeUInt;   // UINT_PTR
  ReceiveBuffer: Pointer;   // BYTE* out
  ReceiveBufferSize: NativeUInt;   // UINT_PTR
  ReceiveDataSize: Pointer;   // UINT_PTR* in/out
  OperationStatus: Pointer   // DWORD* optional, out
): Integer; stdcall;
  external 'winbio.dll' name 'WinBioControlUnit';

result := DllCall("winbio\WinBioControlUnit"
    , "UInt", SessionHandle   ; DWORD
    , "UInt", UnitId   ; DWORD
    , "UInt", Component   ; WINBIO_COMPONENT
    , "UInt", ControlCode   ; DWORD
    , "Ptr", SendBuffer   ; BYTE*
    , "UPtr", SendBufferSize   ; UINT_PTR
    , "Ptr", ReceiveBuffer   ; BYTE* out
    , "UPtr", ReceiveBufferSize   ; UINT_PTR
    , "Ptr", ReceiveDataSize   ; UINT_PTR* in/out
    , "Ptr", OperationStatus   ; DWORD* optional, out
    , "Int")   ; return: HRESULT

●WinBioControlUnit(SessionHandle, UnitId, Component, ControlCode, SendBuffer, SendBufferSize, ReceiveBuffer, ReceiveBufferSize, ReceiveDataSize, OperationStatus) = DLL("winbio.dll", "int WinBioControlUnit(dword, dword, dword, dword, void*, int, void*, int, void*, void*)")
# 呼び出し: WinBioControlUnit(SessionHandle, UnitId, Component, ControlCode, SendBuffer, SendBufferSize, ReceiveBuffer, ReceiveBufferSize, ReceiveDataSize, OperationStatus)
# SessionHandle : DWORD -> "dword"
# UnitId : DWORD -> "dword"
# Component : WINBIO_COMPONENT -> "dword"
# ControlCode : DWORD -> "dword"
# SendBuffer : BYTE* -> "void*"
# SendBufferSize : UINT_PTR -> "int"
# ReceiveBuffer : BYTE* out -> "void*"
# ReceiveBufferSize : UINT_PTR -> "int"
# ReceiveDataSize : UINT_PTR* in/out -> "void*"
# OperationStatus : DWORD* optional, out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。

const std = @import("std");

extern "winbio" fn WinBioControlUnit(
    SessionHandle: u32, // DWORD
    UnitId: u32, // DWORD
    Component: u32, // WINBIO_COMPONENT
    ControlCode: u32, // DWORD
    SendBuffer: [*c]u8, // BYTE*
    SendBufferSize: usize, // UINT_PTR
    ReceiveBuffer: [*c]u8, // BYTE* out
    ReceiveBufferSize: usize, // UINT_PTR
    ReceiveDataSize: [*c]usize, // UINT_PTR* in/out
    OperationStatus: [*c]u32 // DWORD* optional, out
) callconv(std.os.windows.WINAPI) i32;

proc WinBioControlUnit(
    SessionHandle: uint32,  # DWORD
    UnitId: uint32,  # DWORD
    Component: uint32,  # WINBIO_COMPONENT
    ControlCode: uint32,  # DWORD
    SendBuffer: ptr uint8,  # BYTE*
    SendBufferSize: uint,  # UINT_PTR
    ReceiveBuffer: ptr uint8,  # BYTE* out
    ReceiveBufferSize: uint,  # UINT_PTR
    ReceiveDataSize: ptr uint,  # UINT_PTR* in/out
    OperationStatus: ptr uint32  # DWORD* optional, out
): int32 {.importc: "WinBioControlUnit", stdcall, dynlib: "winbio.dll".}

pragma(lib, "winbio");
extern(Windows)
int WinBioControlUnit(
    uint SessionHandle,   // DWORD
    uint UnitId,   // DWORD
    uint Component,   // WINBIO_COMPONENT
    uint ControlCode,   // DWORD
    ubyte* SendBuffer,   // BYTE*
    size_t SendBufferSize,   // UINT_PTR
    ubyte* ReceiveBuffer,   // BYTE* out
    size_t ReceiveBufferSize,   // UINT_PTR
    size_t* ReceiveDataSize,   // UINT_PTR* in/out
    uint* OperationStatus   // DWORD* optional, out
);

ccall((:WinBioControlUnit, "winbio.dll"), stdcall, Int32,
      (UInt32, UInt32, UInt32, UInt32, Ptr{UInt8}, Csize_t, Ptr{UInt8}, Csize_t, Ptr{Csize_t}, Ptr{UInt32}),
      SessionHandle, UnitId, Component, ControlCode, SendBuffer, SendBufferSize, ReceiveBuffer, ReceiveBufferSize, ReceiveDataSize, OperationStatus)
# SessionHandle : DWORD -> UInt32
# UnitId : DWORD -> UInt32
# Component : WINBIO_COMPONENT -> UInt32
# ControlCode : DWORD -> UInt32
# SendBuffer : BYTE* -> Ptr{UInt8}
# SendBufferSize : UINT_PTR -> Csize_t
# ReceiveBuffer : BYTE* out -> Ptr{UInt8}
# ReceiveBufferSize : UINT_PTR -> Csize_t
# ReceiveDataSize : UINT_PTR* in/out -> Ptr{Csize_t}
# OperationStatus : DWORD* optional, out -> Ptr{UInt32}
# stdcall は 32bit のみ意味を持つ(x64 では無視)。

local ffi = require("ffi")
ffi.cdef[[
int32_t WinBioControlUnit(
    uint32_t SessionHandle,
    uint32_t UnitId,
    uint32_t Component,
    uint32_t ControlCode,
    uint8_t* SendBuffer,
    uintptr_t SendBufferSize,
    uint8_t* ReceiveBuffer,
    uintptr_t ReceiveBufferSize,
    uintptr_t* ReceiveDataSize,
    uint32_t* OperationStatus);
]]
local winbio = ffi.load("winbio")
-- winbio.WinBioControlUnit(SessionHandle, UnitId, Component, ControlCode, SendBuffer, SendBufferSize, ReceiveBuffer, ReceiveBufferSize, ReceiveDataSize, OperationStatus)
-- SessionHandle : DWORD
-- UnitId : DWORD
-- Component : WINBIO_COMPONENT
-- ControlCode : DWORD
-- SendBuffer : BYTE*
-- SendBufferSize : UINT_PTR
-- ReceiveBuffer : BYTE* out
-- ReceiveBufferSize : UINT_PTR
-- ReceiveDataSize : UINT_PTR* in/out
-- OperationStatus : DWORD* optional, out
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。

const koffi = require('koffi');
const lib = koffi.load('winbio.dll');
const WinBioControlUnit = lib.func('__stdcall', 'WinBioControlUnit', 'int32_t', ['uint32_t', 'uint32_t', 'uint32_t', 'uint32_t', 'uint8_t *', 'uintptr_t', 'uint8_t *', 'uintptr_t', 'uintptr_t *', 'uint32_t *']);
// WinBioControlUnit(SessionHandle, UnitId, Component, ControlCode, SendBuffer, SendBufferSize, ReceiveBuffer, ReceiveBufferSize, ReceiveDataSize, OperationStatus)
// SessionHandle : DWORD -> 'uint32_t'
// UnitId : DWORD -> 'uint32_t'
// Component : WINBIO_COMPONENT -> 'uint32_t'
// ControlCode : DWORD -> 'uint32_t'
// SendBuffer : BYTE* -> 'uint8_t *'
// SendBufferSize : UINT_PTR -> 'uintptr_t'
// ReceiveBuffer : BYTE* out -> 'uint8_t *'
// ReceiveBufferSize : UINT_PTR -> 'uintptr_t'
// ReceiveDataSize : UINT_PTR* in/out -> 'uintptr_t *'
// OperationStatus : DWORD* optional, out -> 'uint32_t *'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。

const lib = Deno.dlopen("winbio.dll", {
  WinBioControlUnit: { parameters: ["u32", "u32", "u32", "u32", "pointer", "usize", "pointer", "usize", "pointer", "pointer"], result: "i32" },
});
// lib.symbols.WinBioControlUnit(SessionHandle, UnitId, Component, ControlCode, SendBuffer, SendBufferSize, ReceiveBuffer, ReceiveBufferSize, ReceiveDataSize, OperationStatus)
// SessionHandle : DWORD -> "u32"
// UnitId : DWORD -> "u32"
// Component : WINBIO_COMPONENT -> "u32"
// ControlCode : DWORD -> "u32"
// SendBuffer : BYTE* -> "pointer"
// SendBufferSize : UINT_PTR -> "usize"
// ReceiveBuffer : BYTE* out -> "pointer"
// ReceiveBufferSize : UINT_PTR -> "usize"
// ReceiveDataSize : UINT_PTR* in/out -> "pointer"
// OperationStatus : DWORD* optional, out -> "pointer"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。

<?php
$ffi = FFI::cdef(<<<C
int32_t WinBioControlUnit(
    uint32_t SessionHandle,
    uint32_t UnitId,
    uint32_t Component,
    uint32_t ControlCode,
    uint8_t* SendBuffer,
    size_t SendBufferSize,
    uint8_t* ReceiveBuffer,
    size_t ReceiveBufferSize,
    size_t* ReceiveDataSize,
    uint32_t* OperationStatus);
C, "winbio.dll");
// $ffi->WinBioControlUnit(SessionHandle, UnitId, Component, ControlCode, SendBuffer, SendBufferSize, ReceiveBuffer, ReceiveBufferSize, ReceiveDataSize, OperationStatus);
// SessionHandle : DWORD
// UnitId : DWORD
// Component : WINBIO_COMPONENT
// ControlCode : DWORD
// SendBuffer : BYTE*
// SendBufferSize : UINT_PTR
// ReceiveBuffer : BYTE* out
// ReceiveBufferSize : UINT_PTR
// ReceiveDataSize : UINT_PTR* in/out
// OperationStatus : DWORD* optional, out
// 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
// WINAPI(stdcall): x64 では呼出規約が統一されるため問題なし。x86 では __stdcall 対応のラッパが必要な場合あり。

import com.sun.jna.*;
import com.sun.jna.ptr.*;
import com.sun.jna.win32.StdCallLibrary;
import com.sun.jna.win32.W32APIOptions;

public interface Winbio extends StdCallLibrary {
    Winbio INSTANCE = Native.load("winbio", Winbio.class);
    int WinBioControlUnit(
        int SessionHandle,   // DWORD
        int UnitId,   // DWORD
        int Component,   // WINBIO_COMPONENT
        int ControlCode,   // DWORD
        byte[] SendBuffer,   // BYTE*
        long SendBufferSize,   // UINT_PTR
        byte[] ReceiveBuffer,   // BYTE* out
        long ReceiveBufferSize,   // UINT_PTR
        LongByReference ReceiveDataSize,   // UINT_PTR* in/out
        IntByReference OperationStatus   // DWORD* optional, out
    );
}

@[Link("winbio")]
lib Libwinbio
  fun WinBioControlUnit = WinBioControlUnit(
    SessionHandle : UInt32,   # DWORD
    UnitId : UInt32,   # DWORD
    Component : UInt32,   # WINBIO_COMPONENT
    ControlCode : UInt32,   # DWORD
    SendBuffer : UInt8*,   # BYTE*
    SendBufferSize : LibC::SizeT,   # UINT_PTR
    ReceiveBuffer : UInt8*,   # BYTE* out
    ReceiveBufferSize : LibC::SizeT,   # UINT_PTR
    ReceiveDataSize : LibC::SizeT*,   # UINT_PTR* in/out
    OperationStatus : UInt32*   # DWORD* optional, out
  ) : Int32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。

import 'dart:ffi';
import 'package:ffi/ffi.dart';

typedef WinBioControlUnitNative = Int32 Function(Uint32, Uint32, Uint32, Uint32, Pointer<Uint8>, UintPtr, Pointer<Uint8>, UintPtr, Pointer<UintPtr>, Pointer<Uint32>);
typedef WinBioControlUnitDart = int Function(int, int, int, int, Pointer<Uint8>, int, Pointer<Uint8>, int, Pointer<UintPtr>, Pointer<Uint32>);
final WinBioControlUnit = DynamicLibrary.open('winbio.dll')
    .lookupFunction<WinBioControlUnitNative, WinBioControlUnitDart>('WinBioControlUnit');
// SessionHandle : DWORD -> Uint32
// UnitId : DWORD -> Uint32
// Component : WINBIO_COMPONENT -> Uint32
// ControlCode : DWORD -> Uint32
// SendBuffer : BYTE* -> Pointer<Uint8>
// SendBufferSize : UINT_PTR -> UintPtr
// ReceiveBuffer : BYTE* out -> Pointer<Uint8>
// ReceiveBufferSize : UINT_PTR -> UintPtr
// ReceiveDataSize : UINT_PTR* in/out -> Pointer<UintPtr>
// OperationStatus : DWORD* optional, out -> Pointer<Uint32>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。

{$mode objfpc}{$H+}
function WinBioControlUnit(
  SessionHandle: DWORD;   // DWORD
  UnitId: DWORD;   // DWORD
  Component: DWORD;   // WINBIO_COMPONENT
  ControlCode: DWORD;   // DWORD
  SendBuffer: Pointer;   // BYTE*
  SendBufferSize: NativeUInt;   // UINT_PTR
  ReceiveBuffer: Pointer;   // BYTE* out
  ReceiveBufferSize: NativeUInt;   // UINT_PTR
  ReceiveDataSize: Pointer;   // UINT_PTR* in/out
  OperationStatus: Pointer   // DWORD* optional, out
): Integer; stdcall;
  external 'winbio.dll' name 'WinBioControlUnit';

import Foreign
import Foreign.C.Types
import Foreign.C.String

foreign import stdcall safe "WinBioControlUnit"
  c_WinBioControlUnit :: Word32 -> Word32 -> Word32 -> Word32 -> Ptr Word8 -> CUIntPtr -> Ptr Word8 -> CUIntPtr -> Ptr CUIntPtr -> Ptr Word32 -> IO Int32
-- SessionHandle : DWORD -> Word32
-- UnitId : DWORD -> Word32
-- Component : WINBIO_COMPONENT -> Word32
-- ControlCode : DWORD -> Word32
-- SendBuffer : BYTE* -> Ptr Word8
-- SendBufferSize : UINT_PTR -> CUIntPtr
-- ReceiveBuffer : BYTE* out -> Ptr Word8
-- ReceiveBufferSize : UINT_PTR -> CUIntPtr
-- ReceiveDataSize : UINT_PTR* in/out -> Ptr CUIntPtr
-- OperationStatus : DWORD* optional, out -> Ptr Word32
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。

open Ctypes
open Foreign

let winbiocontrolunit =
  foreign "WinBioControlUnit"
    (uint32_t @-> uint32_t @-> uint32_t @-> uint32_t @-> (ptr uint8_t) @-> size_t @-> (ptr uint8_t) @-> size_t @-> (ptr size_t) @-> (ptr uint32_t) @-> returning int32_t)
(* SessionHandle : DWORD -> uint32_t *)
(* UnitId : DWORD -> uint32_t *)
(* Component : WINBIO_COMPONENT -> uint32_t *)
(* ControlCode : DWORD -> uint32_t *)
(* SendBuffer : BYTE* -> (ptr uint8_t) *)
(* SendBufferSize : UINT_PTR -> size_t *)
(* ReceiveBuffer : BYTE* out -> (ptr uint8_t) *)
(* ReceiveBufferSize : UINT_PTR -> size_t *)
(* ReceiveDataSize : UINT_PTR* in/out -> (ptr size_t) *)
(* OperationStatus : DWORD* optional, out -> (ptr uint32_t) *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)

(cffi:define-foreign-library winbio (t "winbio.dll"))
(cffi:use-foreign-library winbio)

(cffi:defcfun ("WinBioControlUnit" win-bio-control-unit :convention :stdcall) :int32
  (session-handle :uint32)   ; DWORD
  (unit-id :uint32)   ; DWORD
  (component :uint32)   ; WINBIO_COMPONENT
  (control-code :uint32)   ; DWORD
  (send-buffer :pointer)   ; BYTE*
  (send-buffer-size :uint64)   ; UINT_PTR
  (receive-buffer :pointer)   ; BYTE* out
  (receive-buffer-size :uint64)   ; UINT_PTR
  (receive-data-size :pointer)   ; UINT_PTR* in/out
  (operation-status :pointer))   ; DWORD* optional, out
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。

use Win32::API;
my $WinBioControlUnit = Win32::API::More->new('winbio',
    'int WinBioControlUnit(DWORD SessionHandle, DWORD UnitId, DWORD Component, DWORD ControlCode, LPVOID SendBuffer, WPARAM SendBufferSize, LPVOID ReceiveBuffer, WPARAM ReceiveBufferSize, LPVOID ReceiveDataSize, LPVOID OperationStatus)');
# my $ret = $WinBioControlUnit->Call($SessionHandle, $UnitId, $Component, $ControlCode, $SendBuffer, $SendBufferSize, $ReceiveBuffer, $ReceiveBufferSize, $ReceiveDataSize, $OperationStatus);
# SessionHandle : DWORD -> DWORD
# UnitId : DWORD -> DWORD
# Component : WINBIO_COMPONENT -> DWORD
# ControlCode : DWORD -> DWORD
# SendBuffer : BYTE* -> LPVOID
# SendBufferSize : UINT_PTR -> WPARAM
# ReceiveBuffer : BYTE* out -> LPVOID
# ReceiveBufferSize : UINT_PTR -> WPARAM
# ReceiveDataSize : UINT_PTR* in/out -> LPVOID
# OperationStatus : DWORD* optional, out -> LPVOID
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。

WinBioControlUnit

シグネチャ

パラメーター

各言語での呼び出し定義

関連項目