Win32 API 日本語リファレンス
ホームMedia.MediaFoundation › MFllMulDiv

MFllMulDiv

関数
64ビット整数の乗算と除算を丸め付きで計算する。
DLLMFPlat.dll呼出規約winapi対応OSWindows 7 以降

シグネチャ

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

LONGLONG MFllMulDiv(
    LONGLONG a,
    LONGLONG b,
    LONGLONG c,
    LONGLONG d
);

パラメーター

名前方向説明
aLONGLONGin乗数。
bLONGLONGinもう一方の乗数。
cLONGLONGin除数。
dLONGLONGin丸め係数。

戻り値の型: LONGLONG

公式ドキュメント

((a * b) + d) / c を計算します。各項は 64 ビット符号付き値です。

戻り値

計算結果を返します。数値オーバーフローが発生した場合、関数は _I64_MAX(正のオーバーフロー)または LLONG_MIN(負のオーバーフロー)を返します。Mfplat.dll を読み込めない場合、関数は _I64_MAX を返します。

解説(Remarks)

Note 本トピックの以前のバージョンでは、パラメーターの説明が誤っていました。除数は c、丸め係数は d です。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での呼び出し定義

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

LONGLONG MFllMulDiv(
    LONGLONG a,
    LONGLONG b,
    LONGLONG c,
    LONGLONG d
);
[DllImport("MFPlat.dll", ExactSpelling = true)]
static extern long MFllMulDiv(
    long a,   // LONGLONG
    long b,   // LONGLONG
    long c,   // LONGLONG
    long d   // LONGLONG
);
<DllImport("MFPlat.dll", ExactSpelling:=True)>
Public Shared Function MFllMulDiv(
    a As Long,   ' LONGLONG
    b As Long,   ' LONGLONG
    c As Long,   ' LONGLONG
    d As Long   ' LONGLONG
) As Long
End Function
' a : LONGLONG
' b : LONGLONG
' c : LONGLONG
' d : LONGLONG
Declare PtrSafe Function MFllMulDiv Lib "mfplat" ( _
    ByVal a As LongLong, _
    ByVal b As LongLong, _
    ByVal c As LongLong, _
    ByVal d As LongLong) As LongLong
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

MFllMulDiv = ctypes.windll.mfplat.MFllMulDiv
MFllMulDiv.restype = ctypes.c_longlong
MFllMulDiv.argtypes = [
    ctypes.c_longlong,  # a : LONGLONG
    ctypes.c_longlong,  # b : LONGLONG
    ctypes.c_longlong,  # c : LONGLONG
    ctypes.c_longlong,  # d : LONGLONG
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('MFPlat.dll')
MFllMulDiv = Fiddle::Function.new(
  lib['MFllMulDiv'],
  [
    Fiddle::TYPE_LONG_LONG,  # a : LONGLONG
    Fiddle::TYPE_LONG_LONG,  # b : LONGLONG
    Fiddle::TYPE_LONG_LONG,  # c : LONGLONG
    Fiddle::TYPE_LONG_LONG,  # d : LONGLONG
  ],
  Fiddle::TYPE_LONG_LONG)
#[link(name = "mfplat")]
extern "system" {
    fn MFllMulDiv(
        a: i64,  // LONGLONG
        b: i64,  // LONGLONG
        c: i64,  // LONGLONG
        d: i64  // LONGLONG
    ) -> i64;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("MFPlat.dll")]
public static extern long MFllMulDiv(long a, long b, long c, long d);
"@
$api = Add-Type -MemberDefinition $sig -Name 'MFPlat_MFllMulDiv' -Namespace Win32 -PassThru
# $api::MFllMulDiv(a, b, c, d)
#uselib "MFPlat.dll"
#func global MFllMulDiv "MFllMulDiv" sptr, sptr, sptr, sptr
; MFllMulDiv a, b, c, d   ; 戻り値は stat
; a : LONGLONG -> "sptr"
; b : LONGLONG -> "sptr"
; c : LONGLONG -> "sptr"
; d : LONGLONG -> "sptr"
; ※HSP3.7は int64 引数(64bit値渡し)に非対応です。
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
#uselib "MFPlat.dll"
#cfunc global MFllMulDiv "MFllMulDiv" int64, int64, int64, int64
; res = MFllMulDiv(a, b, c, d)
; a : LONGLONG -> "int64"
; b : LONGLONG -> "int64"
; c : LONGLONG -> "int64"
; d : LONGLONG -> "int64"
; ※int64 引数の DLL 値渡しは x64 ランタイム(hsp3_64)のみ対応(x86 は未対応)。
; LONGLONG MFllMulDiv(LONGLONG a, LONGLONG b, LONGLONG c, LONGLONG d)
#uselib "MFPlat.dll"
#cfunc global MFllMulDiv "MFllMulDiv" int64, int64, int64, int64
; res = MFllMulDiv(a, b, c, d)
; a : LONGLONG -> "int64"
; b : LONGLONG -> "int64"
; c : LONGLONG -> "int64"
; d : LONGLONG -> "int64"
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	mfplat = windows.NewLazySystemDLL("MFPlat.dll")
	procMFllMulDiv = mfplat.NewProc("MFllMulDiv")
)

// a (LONGLONG), b (LONGLONG), c (LONGLONG), d (LONGLONG)
r1, _, err := procMFllMulDiv.Call(
	uintptr(a),
	uintptr(b),
	uintptr(c),
	uintptr(d),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // LONGLONG
function MFllMulDiv(
  a: Int64;   // LONGLONG
  b: Int64;   // LONGLONG
  c: Int64;   // LONGLONG
  d: Int64   // LONGLONG
): Int64; stdcall;
  external 'MFPlat.dll' name 'MFllMulDiv';
result := DllCall("MFPlat\MFllMulDiv"
    , "Int64", a   ; LONGLONG
    , "Int64", b   ; LONGLONG
    , "Int64", c   ; LONGLONG
    , "Int64", d   ; LONGLONG
    , "Int64")   ; return: LONGLONG
●MFllMulDiv(a, b, c, d) = DLL("MFPlat.dll", "int64 MFllMulDiv(int64, int64, int64, int64)")
# 呼び出し: MFllMulDiv(a, b, c, d)
# a : LONGLONG -> "int64"
# b : LONGLONG -> "int64"
# c : LONGLONG -> "int64"
# d : LONGLONG -> "int64"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。
const std = @import("std");

extern "mfplat" fn MFllMulDiv(
    a: i64, // LONGLONG
    b: i64, // LONGLONG
    c: i64, // LONGLONG
    d: i64 // LONGLONG
) callconv(std.os.windows.WINAPI) i64;
proc MFllMulDiv(
    a: int64,  # LONGLONG
    b: int64,  # LONGLONG
    c: int64,  # LONGLONG
    d: int64  # LONGLONG
): int64 {.importc: "MFllMulDiv", stdcall, dynlib: "MFPlat.dll".}
pragma(lib, "mfplat");
extern(Windows)
long MFllMulDiv(
    long a,   // LONGLONG
    long b,   // LONGLONG
    long c,   // LONGLONG
    long d   // LONGLONG
);
ccall((:MFllMulDiv, "MFPlat.dll"), stdcall, Int64,
      (Int64, Int64, Int64, Int64),
      a, b, c, d)
# a : LONGLONG -> Int64
# b : LONGLONG -> Int64
# c : LONGLONG -> Int64
# d : LONGLONG -> Int64
# stdcall は 32bit のみ意味を持つ(x64 では無視)。
local ffi = require("ffi")
ffi.cdef[[
int64_t MFllMulDiv(
    int64_t a,
    int64_t b,
    int64_t c,
    int64_t d);
]]
local mfplat = ffi.load("mfplat")
-- mfplat.MFllMulDiv(a, b, c, d)
-- a : LONGLONG
-- b : LONGLONG
-- c : LONGLONG
-- d : LONGLONG
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
const koffi = require('koffi');
const lib = koffi.load('MFPlat.dll');
const MFllMulDiv = lib.func('__stdcall', 'MFllMulDiv', 'int64_t', ['int64_t', 'int64_t', 'int64_t', 'int64_t']);
// MFllMulDiv(a, b, c, d)
// a : LONGLONG -> 'int64_t'
// b : LONGLONG -> 'int64_t'
// c : LONGLONG -> 'int64_t'
// d : LONGLONG -> 'int64_t'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。
const lib = Deno.dlopen("MFPlat.dll", {
  MFllMulDiv: { parameters: ["i64", "i64", "i64", "i64"], result: "i64" },
});
// lib.symbols.MFllMulDiv(a, b, c, d)
// a : LONGLONG -> "i64"
// b : LONGLONG -> "i64"
// c : LONGLONG -> "i64"
// d : LONGLONG -> "i64"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。
<?php
$ffi = FFI::cdef(<<<C
int64_t MFllMulDiv(
    int64_t a,
    int64_t b,
    int64_t c,
    int64_t d);
C, "MFPlat.dll");
// $ffi->MFllMulDiv(a, b, c, d);
// a : LONGLONG
// b : LONGLONG
// c : LONGLONG
// d : LONGLONG
// 構造体/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 Mfplat extends StdCallLibrary {
    Mfplat INSTANCE = Native.load("mfplat", Mfplat.class);
    long MFllMulDiv(
        long a,   // LONGLONG
        long b,   // LONGLONG
        long c,   // LONGLONG
        long d   // LONGLONG
    );
}
@[Link("mfplat")]
lib LibMFPlat
  fun MFllMulDiv = MFllMulDiv(
    a : Int64,   # LONGLONG
    b : Int64,   # LONGLONG
    c : Int64,   # LONGLONG
    d : Int64   # LONGLONG
  ) : Int64
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。
import 'dart:ffi';
import 'package:ffi/ffi.dart';

typedef MFllMulDivNative = Int64 Function(Int64, Int64, Int64, Int64);
typedef MFllMulDivDart = int Function(int, int, int, int);
final MFllMulDiv = DynamicLibrary.open('MFPlat.dll')
    .lookupFunction<MFllMulDivNative, MFllMulDivDart>('MFllMulDiv');
// a : LONGLONG -> Int64
// b : LONGLONG -> Int64
// c : LONGLONG -> Int64
// d : LONGLONG -> Int64
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。
{$mode objfpc}{$H+}
function MFllMulDiv(
  a: Int64;   // LONGLONG
  b: Int64;   // LONGLONG
  c: Int64;   // LONGLONG
  d: Int64   // LONGLONG
): Int64; stdcall;
  external 'MFPlat.dll' name 'MFllMulDiv';
import Foreign
import Foreign.C.Types
import Foreign.C.String

foreign import stdcall safe "MFllMulDiv"
  c_MFllMulDiv :: Int64 -> Int64 -> Int64 -> Int64 -> IO Int64
-- a : LONGLONG -> Int64
-- b : LONGLONG -> Int64
-- c : LONGLONG -> Int64
-- d : LONGLONG -> Int64
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。
open Ctypes
open Foreign

let mfllmuldiv =
  foreign "MFllMulDiv"
    (int64_t @-> int64_t @-> int64_t @-> int64_t @-> returning int64_t)
(* a : LONGLONG -> int64_t *)
(* b : LONGLONG -> int64_t *)
(* c : LONGLONG -> int64_t *)
(* d : LONGLONG -> int64_t *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)
(cffi:define-foreign-library mfplat (t "MFPlat.dll"))
(cffi:use-foreign-library mfplat)

(cffi:defcfun ("MFllMulDiv" mfll-mul-div :convention :stdcall) :int64
  (a :int64)   ; LONGLONG
  (b :int64)   ; LONGLONG
  (c :int64)   ; LONGLONG
  (d :int64))   ; LONGLONG
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。
use Win32::API;
my $MFllMulDiv = Win32::API::More->new('MFPlat',
    'INT64 MFllMulDiv(INT64 a, INT64 b, INT64 c, INT64 d)');
# my $ret = $MFllMulDiv->Call($a, $b, $c, $d);
# a : LONGLONG -> INT64
# b : LONGLONG -> INT64
# c : LONGLONG -> INT64
# d : LONGLONG -> INT64
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。