Win32 API 日本語リファレンス
ホームUI.ColorSystem › CMCheckRGBs

CMCheckRGBs

関数
CMMでRGBビットマップが色域内にあるか確認する。
DLLICM32.dll呼出規約winapi

シグネチャ

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

BOOL CMCheckRGBs(
    INT_PTR hcmTransform,
    void* lpSrcBits,
    BMFORMAT bmInput,
    DWORD dwWidth,
    DWORD dwHeight,
    DWORD dwStride,
    BYTE* lpaResult,
    LPBMCALLBACKFN pfnCallback,
    LPARAM ulCallbackData
);

パラメーター

名前方向
hcmTransformINT_PTRin
lpSrcBitsvoid*in
bmInputBMFORMATin
dwWidthDWORDin
dwHeightDWORDin
dwStrideDWORDin
lpaResultBYTE*out
pfnCallbackLPBMCALLBACKFNin
ulCallbackDataLPARAMin

戻り値の型: BOOL

各言語での呼び出し定義

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

BOOL CMCheckRGBs(
    INT_PTR hcmTransform,
    void* lpSrcBits,
    BMFORMAT bmInput,
    DWORD dwWidth,
    DWORD dwHeight,
    DWORD dwStride,
    BYTE* lpaResult,
    LPBMCALLBACKFN pfnCallback,
    LPARAM ulCallbackData
);
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("ICM32.dll", ExactSpelling = true)]
static extern bool CMCheckRGBs(
    IntPtr hcmTransform,   // INT_PTR
    IntPtr lpSrcBits,   // void*
    int bmInput,   // BMFORMAT
    uint dwWidth,   // DWORD
    uint dwHeight,   // DWORD
    uint dwStride,   // DWORD
    IntPtr lpaResult,   // BYTE* out
    IntPtr pfnCallback,   // LPBMCALLBACKFN
    IntPtr ulCallbackData   // LPARAM
);
<DllImport("ICM32.dll", ExactSpelling:=True)>
Public Shared Function CMCheckRGBs(
    hcmTransform As IntPtr,   ' INT_PTR
    lpSrcBits As IntPtr,   ' void*
    bmInput As Integer,   ' BMFORMAT
    dwWidth As UInteger,   ' DWORD
    dwHeight As UInteger,   ' DWORD
    dwStride As UInteger,   ' DWORD
    lpaResult As IntPtr,   ' BYTE* out
    pfnCallback As IntPtr,   ' LPBMCALLBACKFN
    ulCallbackData As IntPtr   ' LPARAM
) As Boolean
End Function
' hcmTransform : INT_PTR
' lpSrcBits : void*
' bmInput : BMFORMAT
' dwWidth : DWORD
' dwHeight : DWORD
' dwStride : DWORD
' lpaResult : BYTE* out
' pfnCallback : LPBMCALLBACKFN
' ulCallbackData : LPARAM
Declare PtrSafe Function CMCheckRGBs Lib "icm32" ( _
    ByVal hcmTransform As LongPtr, _
    ByVal lpSrcBits As LongPtr, _
    ByVal bmInput As Long, _
    ByVal dwWidth As Long, _
    ByVal dwHeight As Long, _
    ByVal dwStride As Long, _
    ByVal lpaResult As LongPtr, _
    ByVal pfnCallback As LongPtr, _
    ByVal ulCallbackData As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

CMCheckRGBs = ctypes.windll.icm32.CMCheckRGBs
CMCheckRGBs.restype = wintypes.BOOL
CMCheckRGBs.argtypes = [
    ctypes.c_ssize_t,  # hcmTransform : INT_PTR
    ctypes.POINTER(None),  # lpSrcBits : void*
    ctypes.c_int,  # bmInput : BMFORMAT
    wintypes.DWORD,  # dwWidth : DWORD
    wintypes.DWORD,  # dwHeight : DWORD
    wintypes.DWORD,  # dwStride : DWORD
    ctypes.POINTER(ctypes.c_ubyte),  # lpaResult : BYTE* out
    ctypes.c_void_p,  # pfnCallback : LPBMCALLBACKFN
    ctypes.c_ssize_t,  # ulCallbackData : LPARAM
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('ICM32.dll')
CMCheckRGBs = Fiddle::Function.new(
  lib['CMCheckRGBs'],
  [
    Fiddle::TYPE_INTPTR_T,  # hcmTransform : INT_PTR
    Fiddle::TYPE_VOIDP,  # lpSrcBits : void*
    Fiddle::TYPE_INT,  # bmInput : BMFORMAT
    -Fiddle::TYPE_INT,  # dwWidth : DWORD
    -Fiddle::TYPE_INT,  # dwHeight : DWORD
    -Fiddle::TYPE_INT,  # dwStride : DWORD
    Fiddle::TYPE_VOIDP,  # lpaResult : BYTE* out
    Fiddle::TYPE_VOIDP,  # pfnCallback : LPBMCALLBACKFN
    Fiddle::TYPE_INTPTR_T,  # ulCallbackData : LPARAM
  ],
  Fiddle::TYPE_INT)
#[link(name = "icm32")]
extern "system" {
    fn CMCheckRGBs(
        hcmTransform: isize,  // INT_PTR
        lpSrcBits: *mut (),  // void*
        bmInput: i32,  // BMFORMAT
        dwWidth: u32,  // DWORD
        dwHeight: u32,  // DWORD
        dwStride: u32,  // DWORD
        lpaResult: *mut u8,  // BYTE* out
        pfnCallback: *const core::ffi::c_void,  // LPBMCALLBACKFN
        ulCallbackData: isize  // LPARAM
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("ICM32.dll")]
public static extern bool CMCheckRGBs(IntPtr hcmTransform, IntPtr lpSrcBits, int bmInput, uint dwWidth, uint dwHeight, uint dwStride, IntPtr lpaResult, IntPtr pfnCallback, IntPtr ulCallbackData);
"@
$api = Add-Type -MemberDefinition $sig -Name 'ICM32_CMCheckRGBs' -Namespace Win32 -PassThru
# $api::CMCheckRGBs(hcmTransform, lpSrcBits, bmInput, dwWidth, dwHeight, dwStride, lpaResult, pfnCallback, ulCallbackData)
#uselib "ICM32.dll"
#func global CMCheckRGBs "CMCheckRGBs" sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr, sptr
; CMCheckRGBs hcmTransform, lpSrcBits, bmInput, dwWidth, dwHeight, dwStride, varptr(lpaResult), pfnCallback, ulCallbackData   ; 戻り値は stat
; hcmTransform : INT_PTR -> "sptr"
; lpSrcBits : void* -> "sptr"
; bmInput : BMFORMAT -> "sptr"
; dwWidth : DWORD -> "sptr"
; dwHeight : DWORD -> "sptr"
; dwStride : DWORD -> "sptr"
; lpaResult : BYTE* out -> "sptr"
; pfnCallback : LPBMCALLBACKFN -> "sptr"
; ulCallbackData : LPARAM -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数:
#uselib "ICM32.dll"
#cfunc global CMCheckRGBs "CMCheckRGBs" sptr, sptr, int, int, int, int, var, sptr, sptr
; res = CMCheckRGBs(hcmTransform, lpSrcBits, bmInput, dwWidth, dwHeight, dwStride, lpaResult, pfnCallback, ulCallbackData)
; hcmTransform : INT_PTR -> "sptr"
; lpSrcBits : void* -> "sptr"
; bmInput : BMFORMAT -> "int"
; dwWidth : DWORD -> "int"
; dwHeight : DWORD -> "int"
; dwStride : DWORD -> "int"
; lpaResult : BYTE* out -> "var"
; pfnCallback : LPBMCALLBACKFN -> "sptr"
; ulCallbackData : LPARAM -> "sptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数:
; BOOL CMCheckRGBs(INT_PTR hcmTransform, void* lpSrcBits, BMFORMAT bmInput, DWORD dwWidth, DWORD dwHeight, DWORD dwStride, BYTE* lpaResult, LPBMCALLBACKFN pfnCallback, LPARAM ulCallbackData)
#uselib "ICM32.dll"
#cfunc global CMCheckRGBs "CMCheckRGBs" intptr, intptr, int, int, int, int, var, intptr, intptr
; res = CMCheckRGBs(hcmTransform, lpSrcBits, bmInput, dwWidth, dwHeight, dwStride, lpaResult, pfnCallback, ulCallbackData)
; hcmTransform : INT_PTR -> "intptr"
; lpSrcBits : void* -> "intptr"
; bmInput : BMFORMAT -> "int"
; dwWidth : DWORD -> "int"
; dwHeight : DWORD -> "int"
; dwStride : DWORD -> "int"
; lpaResult : BYTE* out -> "var"
; pfnCallback : LPBMCALLBACKFN -> "intptr"
; ulCallbackData : LPARAM -> "intptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	icm32 = windows.NewLazySystemDLL("ICM32.dll")
	procCMCheckRGBs = icm32.NewProc("CMCheckRGBs")
)

// hcmTransform (INT_PTR), lpSrcBits (void*), bmInput (BMFORMAT), dwWidth (DWORD), dwHeight (DWORD), dwStride (DWORD), lpaResult (BYTE* out), pfnCallback (LPBMCALLBACKFN), ulCallbackData (LPARAM)
r1, _, err := procCMCheckRGBs.Call(
	uintptr(hcmTransform),
	uintptr(lpSrcBits),
	uintptr(bmInput),
	uintptr(dwWidth),
	uintptr(dwHeight),
	uintptr(dwStride),
	uintptr(lpaResult),
	uintptr(pfnCallback),
	uintptr(ulCallbackData),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // BOOL
function CMCheckRGBs(
  hcmTransform: NativeInt;   // INT_PTR
  lpSrcBits: Pointer;   // void*
  bmInput: Integer;   // BMFORMAT
  dwWidth: DWORD;   // DWORD
  dwHeight: DWORD;   // DWORD
  dwStride: DWORD;   // DWORD
  lpaResult: Pointer;   // BYTE* out
  pfnCallback: Pointer;   // LPBMCALLBACKFN
  ulCallbackData: NativeInt   // LPARAM
): BOOL; stdcall;
  external 'ICM32.dll' name 'CMCheckRGBs';
result := DllCall("ICM32\CMCheckRGBs"
    , "Ptr", hcmTransform   ; INT_PTR
    , "Ptr", lpSrcBits   ; void*
    , "Int", bmInput   ; BMFORMAT
    , "UInt", dwWidth   ; DWORD
    , "UInt", dwHeight   ; DWORD
    , "UInt", dwStride   ; DWORD
    , "Ptr", lpaResult   ; BYTE* out
    , "Ptr", pfnCallback   ; LPBMCALLBACKFN
    , "Ptr", ulCallbackData   ; LPARAM
    , "Int")   ; return: BOOL
●CMCheckRGBs(hcmTransform, lpSrcBits, bmInput, dwWidth, dwHeight, dwStride, lpaResult, pfnCallback, ulCallbackData) = DLL("ICM32.dll", "bool CMCheckRGBs(int, void*, int, dword, dword, dword, void*, void*, int)")
# 呼び出し: CMCheckRGBs(hcmTransform, lpSrcBits, bmInput, dwWidth, dwHeight, dwStride, lpaResult, pfnCallback, ulCallbackData)
# hcmTransform : INT_PTR -> "int"
# lpSrcBits : void* -> "void*"
# bmInput : BMFORMAT -> "int"
# dwWidth : DWORD -> "dword"
# dwHeight : DWORD -> "dword"
# dwStride : DWORD -> "dword"
# lpaResult : BYTE* out -> "void*"
# pfnCallback : LPBMCALLBACKFN -> "void*"
# ulCallbackData : LPARAM -> "int"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。