ホーム › Media.MediaFoundation › MFTranscodeGetAudioOutputAvailableTypes

MFTranscodeGetAudioOutputAvailableTypes

関数

トランスコードで利用可能なオーディオ出力タイプを列挙する。

DLLMF.dll呼出規約winapi対応OSWindows 7 以降

シグネチャ

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

HRESULT MFTranscodeGetAudioOutputAvailableTypes(
    const GUID* guidSubType,
    DWORD dwMFTFlags,
    IMFAttributes* pCodecConfig,   // optional
    IMFCollection** ppAvailableTypes
);

パラメーター

名前

型

方向

説明

guidSubType

GUID*

出力メディアのサブタイプを指定します。エンコーダーは、利用可能な出力タイプを列挙する際にこの値をフィルターとして使用します。オーディオサブタイプについては、Audio Subtype GUIDs を参照してください。

dwMFTFlags

DWORD

_MFT_ENUM_FLAG 列挙体の 0 個以上のフラグのビット単位の OR です。

pCodecConfig

IMFAttributes*

inoptional

属性ストアの IMFAttributes インターフェイスへのポインターです。属性ストアはエンコーダーの構成設定を指定します。このパラメーターには NULL を指定できます。属性ストアには次のいずれの属性も保持できます。

値	意味
MFT_FIELDOFUSE_UNLOCK_Attribute	field-of-use(使用分野)の記述を持つエンコーダーのロックを解除するには、この属性を設定します。
MF_TRANSCODE_ENCODINGPROFILE	Windows Media エンコーダーのデバイス準拠プロファイルを指定します。
MF_TRANSCODE_QUALITYVSSPEED	エンコード品質とエンコード速度のトレードオフを設定します。

ppAvailableTypes

IMFCollection**

out

優先されるオーディオメディアタイプの一覧を含むコレクションオブジェクトの IMFCollection インターフェイスへのポインターを受け取ります。コレクションには IMFMediaType ポインターが格納されます。呼び出し元はこのインターフェイスポインターを解放する必要があります。

戻り値の型: HRESULT

公式ドキュメント

オーディオエンコーダーから出力フォーマットの一覧を取得します。

戻り値

この関数は HRESULT を返します。指定できる値には、次の表に示すものが含まれますが、これらに限定されません。

戻り値	説明
S_OK	関数呼び出しが成功しました。
MF_E_TRANSCODE_NO_MATCHING_ENCODER	指定された構成設定に一致するエンコーダーが見つかりませんでした。

解説(Remarks)

この関数は、エンコーダーが既定のエンコードモード(通常は固定ビットレート(CBR)エンコード)で使用されることを前提としています。そのため、この関数が返すタイプは、可変ビットレート(VBR)エンコードなどの他のモードでは動作しない場合があります。

内部的には、この関数は MFTEnumEx を呼び出して一致するエンコーダーを検索し、続いて IMFTransform::GetOutputAvailableType を呼び出してエンコーダーの出力タイプを取得することで機能します。

例

次の例では、Windows Media Audio (WMA) のトランスコードプロファイルを作成します。

template <class Q>
HRESULT GetCollectionObject(IMFCollection *pCollection, DWORD index, Q **ppObj)
{
    IUnknown *pUnk;
    HRESULT hr = pCollection->GetElement(index, &pUnk);
    if (SUCCEEDED(hr))
    {
        hr = pUnk->QueryInterface(IID_PPV_ARGS(ppObj));
        pUnk->Release();
    }
    return hr;
}

HRESULT CreateTranscodeProfile(IMFTranscodeProfile **ppProfile)
{
    IMFTranscodeProfile *pProfile = NULL;     // Transcode profile.
    IMFCollection   *pAvailableTypes = NULL;  // List of audio media types.
    IMFMediaType    *pAudioType = NULL;       // Audio media type.
    IMFAttributes   *pAudioAttrs = NULL;      // Copy of the audio media type.
    IMFAttributes   *pContainer = NULL;       // Container attributes.

    DWORD dwMTCount = 0;
    
    // Create an empty transcode profile.
    HRESULT hr = MFCreateTranscodeProfile(&pProfile);
    if (FAILED(hr))
    {
        goto done;
    }

    // Get output media types for the Windows Media audio encoder.

    // Enumerate all codecs except for codecs with field-of-use restrictions.
    // Sort the results.

    DWORD dwFlags = 
        (MFT_ENUM_FLAG_ALL & (~MFT_ENUM_FLAG_FIELDOFUSE)) | 
        MFT_ENUM_FLAG_SORTANDFILTER;

    hr = MFTranscodeGetAudioOutputAvailableTypes(MFAudioFormat_WMAudioV9, 
        dwFlags, NULL, &pAvailableTypes);
    if (FAILED(hr))
    {
        goto done;
    }

    hr = pAvailableTypes->GetElementCount(&dwMTCount);
    if (FAILED(hr))
    {
        goto done;
    }
    if (dwMTCount == 0)
    {
        hr = E_FAIL;
        goto done;
    }

    // Get the first audio type in the collection and make a copy.
    hr = GetCollectionObject(pAvailableTypes, 0, &pAudioType);
    if (FAILED(hr))
    {
        goto done;
    }

    hr = MFCreateAttributes(&pAudioAttrs, 0);       
    if (FAILED(hr))
    {
        goto done;
    }

    hr = pAudioType->CopyAllItems(pAudioAttrs);
    if (FAILED(hr))
    {
        goto done;
    }

    // Set the audio attributes on the profile.
    hr = pProfile->SetAudioAttributes(pAudioAttrs);
    if (FAILED(hr))
    {
        goto done;
    }

    // Set the container attributes.
    hr = MFCreateAttributes(&pContainer, 1);
    if (FAILED(hr))
    {
        goto done;
    }

    hr = pContainer->SetGUID(MF_TRANSCODE_CONTAINERTYPE, MFTranscodeContainerType_ASF);
    if (FAILED(hr))
    {
        goto done;
    }

    hr = pProfile->SetContainerAttributes(pContainer);
    if (FAILED(hr))
    {
        goto done;
    }

    *ppProfile = pProfile;
    (*ppProfile)->AddRef();

done:
    SafeRelease(&pProfile);
    SafeRelease(&pAvailableTypes);
    SafeRelease(&pAudioType);
    SafeRelease(&pAudioAttrs);
    SafeRelease(&pContainer);
    return hr;
}

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

各言語での呼び出し定義

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

HRESULT MFTranscodeGetAudioOutputAvailableTypes(
    const GUID* guidSubType,
    DWORD dwMFTFlags,
    IMFAttributes* pCodecConfig,   // optional
    IMFCollection** ppAvailableTypes
);

[DllImport("MF.dll", ExactSpelling = true)]
static extern int MFTranscodeGetAudioOutputAvailableTypes(
    ref Guid guidSubType,   // GUID*
    uint dwMFTFlags,   // DWORD
    IntPtr pCodecConfig,   // IMFAttributes* optional
    IntPtr ppAvailableTypes   // IMFCollection** out
);

<DllImport("MF.dll", ExactSpelling:=True)>
Public Shared Function MFTranscodeGetAudioOutputAvailableTypes(
    ByRef guidSubType As Guid,   ' GUID*
    dwMFTFlags As UInteger,   ' DWORD
    pCodecConfig As IntPtr,   ' IMFAttributes* optional
    ppAvailableTypes As IntPtr   ' IMFCollection** out
) As Integer
End Function

' guidSubType : GUID*
' dwMFTFlags : DWORD
' pCodecConfig : IMFAttributes* optional
' ppAvailableTypes : IMFCollection** out
Declare PtrSafe Function MFTranscodeGetAudioOutputAvailableTypes Lib "mf" ( _
    ByVal guidSubType As LongPtr, _
    ByVal dwMFTFlags As Long, _
    ByVal pCodecConfig As LongPtr, _
    ByVal ppAvailableTypes As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

MFTranscodeGetAudioOutputAvailableTypes = ctypes.windll.mf.MFTranscodeGetAudioOutputAvailableTypes
MFTranscodeGetAudioOutputAvailableTypes.restype = ctypes.c_int
MFTranscodeGetAudioOutputAvailableTypes.argtypes = [
    ctypes.c_void_p,  # guidSubType : GUID*
    wintypes.DWORD,  # dwMFTFlags : DWORD
    ctypes.c_void_p,  # pCodecConfig : IMFAttributes* optional
    ctypes.c_void_p,  # ppAvailableTypes : IMFCollection** out
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('MF.dll')
MFTranscodeGetAudioOutputAvailableTypes = Fiddle::Function.new(
  lib['MFTranscodeGetAudioOutputAvailableTypes'],
  [
    Fiddle::TYPE_VOIDP,  # guidSubType : GUID*
    -Fiddle::TYPE_INT,  # dwMFTFlags : DWORD
    Fiddle::TYPE_VOIDP,  # pCodecConfig : IMFAttributes* optional
    Fiddle::TYPE_VOIDP,  # ppAvailableTypes : IMFCollection** out
  ],
  Fiddle::TYPE_INT)

#[link(name = "mf")]
extern "system" {
    fn MFTranscodeGetAudioOutputAvailableTypes(
        guidSubType: *const GUID,  // GUID*
        dwMFTFlags: u32,  // DWORD
        pCodecConfig: *mut core::ffi::c_void,  // IMFAttributes* optional
        ppAvailableTypes: *mut *mut core::ffi::c_void  // IMFCollection** out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("MF.dll")]
public static extern int MFTranscodeGetAudioOutputAvailableTypes(ref Guid guidSubType, uint dwMFTFlags, IntPtr pCodecConfig, IntPtr ppAvailableTypes);
"@
$api = Add-Type -MemberDefinition $sig -Name 'MF_MFTranscodeGetAudioOutputAvailableTypes' -Namespace Win32 -PassThru
# $api::MFTranscodeGetAudioOutputAvailableTypes(guidSubType, dwMFTFlags, pCodecConfig, ppAvailableTypes)

#uselib "MF.dll"
#func global MFTranscodeGetAudioOutputAvailableTypes "MFTranscodeGetAudioOutputAvailableTypes" sptr, sptr, sptr, sptr
; MFTranscodeGetAudioOutputAvailableTypes varptr(guidSubType), dwMFTFlags, pCodecConfig, ppAvailableTypes   ; 戻り値は stat
; guidSubType : GUID* -> "sptr"
; dwMFTFlags : DWORD -> "sptr"
; pCodecConfig : IMFAttributes* optional -> "sptr"
; ppAvailableTypes : IMFCollection** out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "MF.dll"
#cfunc global MFTranscodeGetAudioOutputAvailableTypes "MFTranscodeGetAudioOutputAvailableTypes" var, int, sptr, sptr
; res = MFTranscodeGetAudioOutputAvailableTypes(guidSubType, dwMFTFlags, pCodecConfig, ppAvailableTypes)
; guidSubType : GUID* -> "var"
; dwMFTFlags : DWORD -> "int"
; pCodecConfig : IMFAttributes* optional -> "sptr"
; ppAvailableTypes : IMFCollection** out -> "sptr"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "MF.dll"
#cfunc global MFTranscodeGetAudioOutputAvailableTypes "MFTranscodeGetAudioOutputAvailableTypes" sptr, int, sptr, sptr
; res = MFTranscodeGetAudioOutputAvailableTypes(varptr(guidSubType), dwMFTFlags, pCodecConfig, ppAvailableTypes)
; guidSubType : GUID* -> "sptr"
; dwMFTFlags : DWORD -> "int"
; pCodecConfig : IMFAttributes* optional -> "sptr"
; ppAvailableTypes : IMFCollection** out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。