ホーム › Media.MediaFoundation › DXVA2CreateDirect3DDeviceManager9

DXVA2CreateDirect3DDeviceManager9

関数

DXVA2用のDirect3D9デバイスマネージャを生成する。

DLLdxva2.dll呼出規約winapi対応OSWindows Vista 以降

シグネチャ

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

HRESULT DXVA2CreateDirect3DDeviceManager9(
    DWORD* pResetToken,
    IDirect3DDeviceManager9** ppDeviceManager
);

パラメーター

名前	型	方向	説明
pResetToken	DWORD*	out	この Direct3D device manager のインスタンスを識別するトークンを受け取ります。IDirect3DDeviceManager9::ResetDevice を呼び出す際にこのトークンを使用します。
ppDeviceManager	IDirect3DDeviceManager9**	out	IDirect3DDeviceManager9 インターフェイスへのポインターを受け取ります。呼び出し元はこのインターフェイスを解放する必要があります。

戻り値の型: HRESULT

公式ドキュメント

Direct3D Device Manager のインスタンスを作成します。

戻り値

この関数が成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

解説(Remarks)

Windows ストアアプリでは、IMFDXGIDeviceManager と Direct3D 11 Video APIs を使用する必要があります。

例

HRESULT CreateD3DDeviceManager(
    IDirect3DDevice9 *pDevice, 
    UINT *pReset, 
    IDirect3DDeviceManager9 **ppManager
    )
{
    UINT resetToken = 0;

    IDirect3DDeviceManager9 *pD3DManager = NULL;

    HRESULT hr = DXVA2CreateDirect3DDeviceManager9(&resetToken, &pD3DManager);

    if (FAILED(hr))
    {
        goto done;
    }

    hr = pD3DManager->ResetDevice(pDevice, resetToken);

    if (FAILED(hr))
    {
        goto done;
    }

    *ppManager = pD3DManager;
    (*ppManager)->AddRef();

    *pReset = resetToken;


done:
    SafeRelease(&pD3DManager);
    return hr;
}

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での呼び出し定義

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

HRESULT DXVA2CreateDirect3DDeviceManager9(
    DWORD* pResetToken,
    IDirect3DDeviceManager9** ppDeviceManager
);

[DllImport("dxva2.dll", ExactSpelling = true)]
static extern int DXVA2CreateDirect3DDeviceManager9(
    out uint pResetToken,   // DWORD* out
    IntPtr ppDeviceManager   // IDirect3DDeviceManager9** out
);

<DllImport("dxva2.dll", ExactSpelling:=True)>
Public Shared Function DXVA2CreateDirect3DDeviceManager9(
    <Out> ByRef pResetToken As UInteger,   ' DWORD* out
    ppDeviceManager As IntPtr   ' IDirect3DDeviceManager9** out
) As Integer
End Function

' pResetToken : DWORD* out
' ppDeviceManager : IDirect3DDeviceManager9** out
Declare PtrSafe Function DXVA2CreateDirect3DDeviceManager9 Lib "dxva2" ( _
    ByRef pResetToken As Long, _
    ByVal ppDeviceManager As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

DXVA2CreateDirect3DDeviceManager9 = ctypes.windll.dxva2.DXVA2CreateDirect3DDeviceManager9
DXVA2CreateDirect3DDeviceManager9.restype = ctypes.c_int
DXVA2CreateDirect3DDeviceManager9.argtypes = [
    ctypes.POINTER(wintypes.DWORD),  # pResetToken : DWORD* out
    ctypes.c_void_p,  # ppDeviceManager : IDirect3DDeviceManager9** out
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('dxva2.dll')
DXVA2CreateDirect3DDeviceManager9 = Fiddle::Function.new(
  lib['DXVA2CreateDirect3DDeviceManager9'],
  [
    Fiddle::TYPE_VOIDP,  # pResetToken : DWORD* out
    Fiddle::TYPE_VOIDP,  # ppDeviceManager : IDirect3DDeviceManager9** out
  ],
  Fiddle::TYPE_INT)

#[link(name = "dxva2")]
extern "system" {
    fn DXVA2CreateDirect3DDeviceManager9(
        pResetToken: *mut u32,  // DWORD* out
        ppDeviceManager: *mut *mut core::ffi::c_void  // IDirect3DDeviceManager9** out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("dxva2.dll")]
public static extern int DXVA2CreateDirect3DDeviceManager9(out uint pResetToken, IntPtr ppDeviceManager);
"@
$api = Add-Type -MemberDefinition $sig -Name 'dxva2_DXVA2CreateDirect3DDeviceManager9' -Namespace Win32 -PassThru
# $api::DXVA2CreateDirect3DDeviceManager9(pResetToken, ppDeviceManager)

#uselib "dxva2.dll"
#func global DXVA2CreateDirect3DDeviceManager9 "DXVA2CreateDirect3DDeviceManager9" sptr, sptr
; DXVA2CreateDirect3DDeviceManager9 varptr(pResetToken), ppDeviceManager   ; 戻り値は stat
; pResetToken : DWORD* out -> "sptr"
; ppDeviceManager : IDirect3DDeviceManager9** out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "dxva2.dll"
#cfunc global DXVA2CreateDirect3DDeviceManager9 "DXVA2CreateDirect3DDeviceManager9" var, sptr
; res = DXVA2CreateDirect3DDeviceManager9(pResetToken, ppDeviceManager)
; pResetToken : DWORD* out -> "var"
; ppDeviceManager : IDirect3DDeviceManager9** out -> "sptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "dxva2.dll"
#cfunc global DXVA2CreateDirect3DDeviceManager9 "DXVA2CreateDirect3DDeviceManager9" sptr, sptr
; res = DXVA2CreateDirect3DDeviceManager9(varptr(pResetToken), ppDeviceManager)
; pResetToken : DWORD* out -> "sptr"
; ppDeviceManager : IDirect3DDeviceManager9** out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。