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

DMOEnum

関数
指定条件に合致するDMOを列挙する列挙子を取得する。
DLLmsdmo.dll呼出規約winapi
📘 Microsoft Learn (日本語) · English

シグネチャ

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

HRESULT DMOEnum(
    const GUID* guidCategory,
    DWORD dwFlags,
    DWORD cInTypes,
    const DMO_PARTIAL_MEDIATYPE* pInTypes,
    DWORD cOutTypes,
    const DMO_PARTIAL_MEDIATYPE* pOutTypes,
    IEnumDMO** ppEnum
);

パラメーター

名前型方向説明
guidCategoryGUID*in列挙するDMOのカテゴリーGUIDへのポインター。GUID_NULLで全カテゴリーが対象。
dwFlagsDWORDin列挙時の絞り込みフラグ。DMO_ENUMF_INCLUDE_KEYED等を指定する。
cInTypesDWORDinpInTypes配列が持つ入力メディア型の要素数。0で入力型を問わない。
pInTypesDMO_PARTIAL_MEDIATYPE*in絞り込み条件となる入力メディア型のDMO_PARTIAL_MEDIATYPE配列へのポインター。NULL可。
cOutTypesDWORDinpOutTypes配列が持つ出力メディア型の要素数。0で出力型を問わない。
pOutTypesDMO_PARTIAL_MEDIATYPE*in絞り込み条件となる出力メディア型のDMO_PARTIAL_MEDIATYPE配列へのポインター。NULL可。
ppEnumIEnumDMO**out条件に合致するDMOを列挙するIEnumDMOインターフェイスを受け取るポインター。

戻り値の型: HRESULT

各言語での呼び出し定義

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

HRESULT DMOEnum(
    const GUID* guidCategory,
    DWORD dwFlags,
    DWORD cInTypes,
    const DMO_PARTIAL_MEDIATYPE* pInTypes,
    DWORD cOutTypes,
    const DMO_PARTIAL_MEDIATYPE* pOutTypes,
    IEnumDMO** ppEnum
);
[DllImport("msdmo.dll", ExactSpelling = true)]
static extern int DMOEnum(
    ref Guid guidCategory,   // GUID*
    uint dwFlags,   // DWORD
    uint cInTypes,   // DWORD
    IntPtr pInTypes,   // DMO_PARTIAL_MEDIATYPE*
    uint cOutTypes,   // DWORD
    IntPtr pOutTypes,   // DMO_PARTIAL_MEDIATYPE*
    IntPtr ppEnum   // IEnumDMO** out
);
<DllImport("msdmo.dll", ExactSpelling:=True)>
Public Shared Function DMOEnum(
    ByRef guidCategory As Guid,   ' GUID*
    dwFlags As UInteger,   ' DWORD
    cInTypes As UInteger,   ' DWORD
    pInTypes As IntPtr,   ' DMO_PARTIAL_MEDIATYPE*
    cOutTypes As UInteger,   ' DWORD
    pOutTypes As IntPtr,   ' DMO_PARTIAL_MEDIATYPE*
    ppEnum As IntPtr   ' IEnumDMO** out
) As Integer
End Function
' guidCategory : GUID*
' dwFlags : DWORD
' cInTypes : DWORD
' pInTypes : DMO_PARTIAL_MEDIATYPE*
' cOutTypes : DWORD
' pOutTypes : DMO_PARTIAL_MEDIATYPE*
' ppEnum : IEnumDMO** out
Declare PtrSafe Function DMOEnum Lib "msdmo" ( _
    ByVal guidCategory As LongPtr, _
    ByVal dwFlags As Long, _
    ByVal cInTypes As Long, _
    ByVal pInTypes As LongPtr, _
    ByVal cOutTypes As Long, _
    ByVal pOutTypes As LongPtr, _
    ByVal ppEnum As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

DMOEnum = ctypes.windll.msdmo.DMOEnum
DMOEnum.restype = ctypes.c_int
DMOEnum.argtypes = [
    ctypes.c_void_p,  # guidCategory : GUID*
    wintypes.DWORD,  # dwFlags : DWORD
    wintypes.DWORD,  # cInTypes : DWORD
    ctypes.c_void_p,  # pInTypes : DMO_PARTIAL_MEDIATYPE*
    wintypes.DWORD,  # cOutTypes : DWORD
    ctypes.c_void_p,  # pOutTypes : DMO_PARTIAL_MEDIATYPE*
    ctypes.c_void_p,  # ppEnum : IEnumDMO** out
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('msdmo.dll')
DMOEnum = Fiddle::Function.new(
  lib['DMOEnum'],
  [
    Fiddle::TYPE_VOIDP,  # guidCategory : GUID*
    -Fiddle::TYPE_INT,  # dwFlags : DWORD
    -Fiddle::TYPE_INT,  # cInTypes : DWORD
    Fiddle::TYPE_VOIDP,  # pInTypes : DMO_PARTIAL_MEDIATYPE*
    -Fiddle::TYPE_INT,  # cOutTypes : DWORD
    Fiddle::TYPE_VOIDP,  # pOutTypes : DMO_PARTIAL_MEDIATYPE*
    Fiddle::TYPE_VOIDP,  # ppEnum : IEnumDMO** out
  ],
  Fiddle::TYPE_INT)
#[link(name = "msdmo")]
extern "system" {
    fn DMOEnum(
        guidCategory: *const GUID,  // GUID*
        dwFlags: u32,  // DWORD
        cInTypes: u32,  // DWORD
        pInTypes: *const DMO_PARTIAL_MEDIATYPE,  // DMO_PARTIAL_MEDIATYPE*
        cOutTypes: u32,  // DWORD
        pOutTypes: *const DMO_PARTIAL_MEDIATYPE,  // DMO_PARTIAL_MEDIATYPE*
        ppEnum: *mut *mut core::ffi::c_void  // IEnumDMO** out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("msdmo.dll")]
public static extern int DMOEnum(ref Guid guidCategory, uint dwFlags, uint cInTypes, IntPtr pInTypes, uint cOutTypes, IntPtr pOutTypes, IntPtr ppEnum);
"@
$api = Add-Type -MemberDefinition $sig -Name 'msdmo_DMOEnum' -Namespace Win32 -PassThru
# $api::DMOEnum(guidCategory, dwFlags, cInTypes, pInTypes, cOutTypes, pOutTypes, ppEnum)
#uselib "msdmo.dll"
#func global DMOEnum "DMOEnum" sptr, sptr, sptr, sptr, sptr, sptr, sptr
; DMOEnum varptr(guidCategory), dwFlags, cInTypes, varptr(pInTypes), cOutTypes, varptr(pOutTypes), ppEnum   ; 戻り値は stat
; guidCategory : GUID* -> "sptr"
; dwFlags : DWORD -> "sptr"
; cInTypes : DWORD -> "sptr"
; pInTypes : DMO_PARTIAL_MEDIATYPE* -> "sptr"
; cOutTypes : DWORD -> "sptr"
; pOutTypes : DMO_PARTIAL_MEDIATYPE* -> "sptr"
; ppEnum : IEnumDMO** out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数: 
#uselib "msdmo.dll"
#cfunc global DMOEnum "DMOEnum" var, int, int, var, int, var, sptr
; res = DMOEnum(guidCategory, dwFlags, cInTypes, pInTypes, cOutTypes, pOutTypes, ppEnum)
; guidCategory : GUID* -> "var"
; dwFlags : DWORD -> "int"
; cInTypes : DWORD -> "int"
; pInTypes : DMO_PARTIAL_MEDIATYPE* -> "var"
; cOutTypes : DWORD -> "int"
; pOutTypes : DMO_PARTIAL_MEDIATYPE* -> "var"
; ppEnum : IEnumDMO** out -> "sptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数: 
; HRESULT DMOEnum(GUID* guidCategory, DWORD dwFlags, DWORD cInTypes, DMO_PARTIAL_MEDIATYPE* pInTypes, DWORD cOutTypes, DMO_PARTIAL_MEDIATYPE* pOutTypes, IEnumDMO** ppEnum)
#uselib "msdmo.dll"
#cfunc global DMOEnum "DMOEnum" var, int, int, var, int, var, intptr
; res = DMOEnum(guidCategory, dwFlags, cInTypes, pInTypes, cOutTypes, pOutTypes, ppEnum)
; guidCategory : GUID* -> "var"
; dwFlags : DWORD -> "int"
; cInTypes : DWORD -> "int"
; pInTypes : DMO_PARTIAL_MEDIATYPE* -> "var"
; cOutTypes : DWORD -> "int"
; pOutTypes : DMO_PARTIAL_MEDIATYPE* -> "var"
; ppEnum : IEnumDMO** out -> "intptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	msdmo = windows.NewLazySystemDLL("msdmo.dll")
	procDMOEnum = msdmo.NewProc("DMOEnum")
)

// guidCategory (GUID*), dwFlags (DWORD), cInTypes (DWORD), pInTypes (DMO_PARTIAL_MEDIATYPE*), cOutTypes (DWORD), pOutTypes (DMO_PARTIAL_MEDIATYPE*), ppEnum (IEnumDMO** out)
r1, _, err := procDMOEnum.Call(
	uintptr(guidCategory),
	uintptr(dwFlags),
	uintptr(cInTypes),
	uintptr(pInTypes),
	uintptr(cOutTypes),
	uintptr(pOutTypes),
	uintptr(ppEnum),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // HRESULT
function DMOEnum(
  guidCategory: PGUID;   // GUID*
  dwFlags: DWORD;   // DWORD
  cInTypes: DWORD;   // DWORD
  pInTypes: Pointer;   // DMO_PARTIAL_MEDIATYPE*
  cOutTypes: DWORD;   // DWORD
  pOutTypes: Pointer;   // DMO_PARTIAL_MEDIATYPE*
  ppEnum: Pointer   // IEnumDMO** out
): Integer; stdcall;
  external 'msdmo.dll' name 'DMOEnum';
result := DllCall("msdmo\DMOEnum"
    , "Ptr", guidCategory   ; GUID*
    , "UInt", dwFlags   ; DWORD
    , "UInt", cInTypes   ; DWORD
    , "Ptr", pInTypes   ; DMO_PARTIAL_MEDIATYPE*
    , "UInt", cOutTypes   ; DWORD
    , "Ptr", pOutTypes   ; DMO_PARTIAL_MEDIATYPE*
    , "Ptr", ppEnum   ; IEnumDMO** out
    , "Int")   ; return: HRESULT
●DMOEnum(guidCategory, dwFlags, cInTypes, pInTypes, cOutTypes, pOutTypes, ppEnum) = DLL("msdmo.dll", "int DMOEnum(void*, dword, dword, void*, dword, void*, void*)")
# 呼び出し: DMOEnum(guidCategory, dwFlags, cInTypes, pInTypes, cOutTypes, pOutTypes, ppEnum)
# guidCategory : GUID* -> "void*"
# dwFlags : DWORD -> "dword"
# cInTypes : DWORD -> "dword"
# pInTypes : DMO_PARTIAL_MEDIATYPE* -> "void*"
# cOutTypes : DWORD -> "dword"
# pOutTypes : DMO_PARTIAL_MEDIATYPE* -> "void*"
# ppEnum : IEnumDMO** out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。