ホーム › Devices.DeviceAndDriverInstallation › CM_Register_Device_InterfaceA

CM_Register_Device_InterfaceA

関数

デバイスインターフェイスのインスタンスを登録する。

DLLCFGMGR32.dll文字セットANSI (-A)呼出規約winapi

シグネチャ

// CFGMGR32.dll  (ANSI / -A)
#include <windows.h>

CONFIGRET CM_Register_Device_InterfaceA(
    DWORD dnDevInst,
    GUID* InterfaceClassGuid,
    LPCSTR pszReference,   // optional
    LPSTR pszDeviceInterface,
    DWORD* pulLength,
    DWORD ulFlags
);

パラメーター

名前	型	方向
dnDevInst	DWORD	in
InterfaceClassGuid	GUID*	in
pszReference	LPCSTR	inoptional
pszDeviceInterface	LPSTR	out
pulLength	DWORD*	inout
ulFlags	DWORD	in

戻り値の型: CONFIGRET

各言語での呼び出し定義

// CFGMGR32.dll  (ANSI / -A)
#include <windows.h>

CONFIGRET CM_Register_Device_InterfaceA(
    DWORD dnDevInst,
    GUID* InterfaceClassGuid,
    LPCSTR pszReference,   // optional
    LPSTR pszDeviceInterface,
    DWORD* pulLength,
    DWORD ulFlags
);

[DllImport("CFGMGR32.dll", CharSet = CharSet.Ansi, ExactSpelling = true)]
static extern uint CM_Register_Device_InterfaceA(
    uint dnDevInst,   // DWORD
    ref Guid InterfaceClassGuid,   // GUID*
    [MarshalAs(UnmanagedType.LPStr)] string pszReference,   // LPCSTR optional
    [MarshalAs(UnmanagedType.LPStr)] System.Text.StringBuilder pszDeviceInterface,   // LPSTR out
    ref uint pulLength,   // DWORD* in/out
    uint ulFlags   // DWORD
);

<DllImport("CFGMGR32.dll", CharSet:=CharSet.Ansi, ExactSpelling:=True)>
Public Shared Function CM_Register_Device_InterfaceA(
    dnDevInst As UInteger,   ' DWORD
    ByRef InterfaceClassGuid As Guid,   ' GUID*
    <MarshalAs(UnmanagedType.LPStr)> pszReference As String,   ' LPCSTR optional
    <MarshalAs(UnmanagedType.LPStr)> pszDeviceInterface As System.Text.StringBuilder,   ' LPSTR out
    ByRef pulLength As UInteger,   ' DWORD* in/out
    ulFlags As UInteger   ' DWORD
) As UInteger
End Function

' dnDevInst : DWORD
' InterfaceClassGuid : GUID*
' pszReference : LPCSTR optional
' pszDeviceInterface : LPSTR out
' pulLength : DWORD* in/out
' ulFlags : DWORD
Declare PtrSafe Function CM_Register_Device_InterfaceA Lib "cfgmgr32" ( _
    ByVal dnDevInst As Long, _
    ByVal InterfaceClassGuid As LongPtr, _
    ByVal pszReference As String, _
    ByVal pszDeviceInterface As String, _
    ByRef pulLength As Long, _
    ByVal ulFlags As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

CM_Register_Device_InterfaceA = ctypes.windll.cfgmgr32.CM_Register_Device_InterfaceA
CM_Register_Device_InterfaceA.restype = wintypes.DWORD
CM_Register_Device_InterfaceA.argtypes = [
    wintypes.DWORD,  # dnDevInst : DWORD
    ctypes.c_void_p,  # InterfaceClassGuid : GUID*
    wintypes.LPCSTR,  # pszReference : LPCSTR optional
    wintypes.LPSTR,  # pszDeviceInterface : LPSTR out
    ctypes.POINTER(wintypes.DWORD),  # pulLength : DWORD* in/out
    wintypes.DWORD,  # ulFlags : DWORD
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('CFGMGR32.dll')
CM_Register_Device_InterfaceA = Fiddle::Function.new(
  lib['CM_Register_Device_InterfaceA'],
  [
    -Fiddle::TYPE_INT,  # dnDevInst : DWORD
    Fiddle::TYPE_VOIDP,  # InterfaceClassGuid : GUID*
    Fiddle::TYPE_VOIDP,  # pszReference : LPCSTR optional
    Fiddle::TYPE_VOIDP,  # pszDeviceInterface : LPSTR out
    Fiddle::TYPE_VOIDP,  # pulLength : DWORD* in/out
    -Fiddle::TYPE_INT,  # ulFlags : DWORD
  ],
  -Fiddle::TYPE_INT)

#[link(name = "cfgmgr32")]
extern "system" {
    fn CM_Register_Device_InterfaceA(
        dnDevInst: u32,  // DWORD
        InterfaceClassGuid: *mut GUID,  // GUID*
        pszReference: *const u8,  // LPCSTR optional
        pszDeviceInterface: *mut u8,  // LPSTR out
        pulLength: *mut u32,  // DWORD* in/out
        ulFlags: u32  // DWORD
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("CFGMGR32.dll", CharSet = CharSet.Ansi)]
public static extern uint CM_Register_Device_InterfaceA(uint dnDevInst, ref Guid InterfaceClassGuid, [MarshalAs(UnmanagedType.LPStr)] string pszReference, [MarshalAs(UnmanagedType.LPStr)] System.Text.StringBuilder pszDeviceInterface, ref uint pulLength, uint ulFlags);
"@
$api = Add-Type -MemberDefinition $sig -Name 'CFGMGR32_CM_Register_Device_InterfaceA' -Namespace Win32 -PassThru
# $api::CM_Register_Device_InterfaceA(dnDevInst, InterfaceClassGuid, pszReference, pszDeviceInterface, pulLength, ulFlags)

#uselib "CFGMGR32.dll"
#func global CM_Register_Device_InterfaceA "CM_Register_Device_InterfaceA" sptr, sptr, sptr, sptr, sptr, sptr
; CM_Register_Device_InterfaceA dnDevInst, varptr(InterfaceClassGuid), pszReference, varptr(pszDeviceInterface), varptr(pulLength), ulFlags   ; 戻り値は stat
; dnDevInst : DWORD -> "sptr"
; InterfaceClassGuid : GUID* -> "sptr"
; pszReference : LPCSTR optional -> "sptr"
; pszDeviceInterface : LPSTR out -> "sptr"
; pulLength : DWORD* in/out -> "sptr"
; ulFlags : DWORD -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "CFGMGR32.dll"
#cfunc global CM_Register_Device_InterfaceA "CM_Register_Device_InterfaceA" int, var, str, var, var, int
; res = CM_Register_Device_InterfaceA(dnDevInst, InterfaceClassGuid, pszReference, pszDeviceInterface, pulLength, ulFlags)
; dnDevInst : DWORD -> "int"
; InterfaceClassGuid : GUID* -> "var"
; pszReference : LPCSTR optional -> "str"
; pszDeviceInterface : LPSTR out -> "var"
; pulLength : DWORD* in/out -> "var"
; ulFlags : DWORD -> "int"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "CFGMGR32.dll"
#cfunc global CM_Register_Device_InterfaceA "CM_Register_Device_InterfaceA" int, sptr, str, sptr, sptr, int
; res = CM_Register_Device_InterfaceA(dnDevInst, varptr(InterfaceClassGuid), pszReference, varptr(pszDeviceInterface), varptr(pulLength), ulFlags)
; dnDevInst : DWORD -> "int"
; InterfaceClassGuid : GUID* -> "sptr"
; pszReference : LPCSTR optional -> "str"
; pszDeviceInterface : LPSTR out -> "sptr"
; pulLength : DWORD* in/out -> "sptr"
; ulFlags : DWORD -> "int"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。

出力引数:

; CONFIGRET CM_Register_Device_InterfaceA(DWORD dnDevInst, GUID* InterfaceClassGuid, LPCSTR pszReference, LPSTR pszDeviceInterface, DWORD* pulLength, DWORD ulFlags)
#uselib "CFGMGR32.dll"
#cfunc global CM_Register_Device_InterfaceA "CM_Register_Device_InterfaceA" int, var, str, var, var, int
; res = CM_Register_Device_InterfaceA(dnDevInst, InterfaceClassGuid, pszReference, pszDeviceInterface, pulLength, ulFlags)
; dnDevInst : DWORD -> "int"
; InterfaceClassGuid : GUID* -> "var"
; pszReference : LPCSTR optional -> "str"
; pszDeviceInterface : LPSTR out -> "var"
; pulLength : DWORD* in/out -> "var"
; ulFlags : DWORD -> "int"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; CONFIGRET CM_Register_Device_InterfaceA(DWORD dnDevInst, GUID* InterfaceClassGuid, LPCSTR pszReference, LPSTR pszDeviceInterface, DWORD* pulLength, DWORD ulFlags)
#uselib "CFGMGR32.dll"
#cfunc global CM_Register_Device_InterfaceA "CM_Register_Device_InterfaceA" int, intptr, str, intptr, intptr, int
; res = CM_Register_Device_InterfaceA(dnDevInst, varptr(InterfaceClassGuid), pszReference, varptr(pszDeviceInterface), varptr(pulLength), ulFlags)
; dnDevInst : DWORD -> "int"
; InterfaceClassGuid : GUID* -> "intptr"
; pszReference : LPCSTR optional -> "str"
; pszDeviceInterface : LPSTR out -> "intptr"
; pulLength : DWORD* in/out -> "intptr"
; ulFlags : DWORD -> "int"
; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。

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

var (
	cfgmgr32 = windows.NewLazySystemDLL("CFGMGR32.dll")
	procCM_Register_Device_InterfaceA = cfgmgr32.NewProc("CM_Register_Device_InterfaceA")
)

// dnDevInst (DWORD), InterfaceClassGuid (GUID*), pszReference (LPCSTR optional), pszDeviceInterface (LPSTR out), pulLength (DWORD* in/out), ulFlags (DWORD)
r1, _, err := procCM_Register_Device_InterfaceA.Call(
	uintptr(dnDevInst),
	uintptr(InterfaceClassGuid),
	uintptr(unsafe.Pointer(windows.BytePtrFromString(pszReference))),
	uintptr(pszDeviceInterface),
	uintptr(pulLength),
	uintptr(ulFlags),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // CONFIGRET

function CM_Register_Device_InterfaceA(
  dnDevInst: DWORD;   // DWORD
  InterfaceClassGuid: PGUID;   // GUID*
  pszReference: PAnsiChar;   // LPCSTR optional
  pszDeviceInterface: PAnsiChar;   // LPSTR out
  pulLength: Pointer;   // DWORD* in/out
  ulFlags: DWORD   // DWORD
): DWORD; stdcall;
  external 'CFGMGR32.dll' name 'CM_Register_Device_InterfaceA';

result := DllCall("CFGMGR32\CM_Register_Device_InterfaceA"
    , "UInt", dnDevInst   ; DWORD
    , "Ptr", InterfaceClassGuid   ; GUID*
    , "AStr", pszReference   ; LPCSTR optional
    , "Ptr", pszDeviceInterface   ; LPSTR out
    , "Ptr", pulLength   ; DWORD* in/out
    , "UInt", ulFlags   ; DWORD
    , "UInt")   ; return: CONFIGRET

●CM_Register_Device_InterfaceA(dnDevInst, InterfaceClassGuid, pszReference, pszDeviceInterface, pulLength, ulFlags) = DLL("CFGMGR32.dll", "dword CM_Register_Device_InterfaceA(dword, void*, char*, char*, void*, dword)")
# 呼び出し: CM_Register_Device_InterfaceA(dnDevInst, InterfaceClassGuid, pszReference, pszDeviceInterface, pulLength, ulFlags)
# dnDevInst : DWORD -> "dword"
# InterfaceClassGuid : GUID* -> "void*"
# pszReference : LPCSTR optional -> "char*"
# pszDeviceInterface : LPSTR out -> "char*"
# pulLength : DWORD* in/out -> "void*"
# ulFlags : DWORD -> "dword"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。