設定 WMV 編碼器

發行項
06/13/2023

若要為 Windows Media Video (WMV) 編碼器建立有效的輸出類型，您必須具備下列資訊：

您要編碼之未壓縮視訊的格式。
代表編碼 WMV 格式的視訊子類型。請參閱影片子類型 GUID。
編碼資料流程的目標位元速率。
在編碼器上設定的組態屬性。

設定屬性記載于 Windows 媒體音訊和視訊編解碼器和 DSP API 檔中。如需詳細資訊，請參閱編碼屬性中的。

若要取得編碼器的有效輸出類型，請執行下列步驟。

使用 MFTEnum 或 MFTEnumEx 函 式來建立編碼器的實例。
查詢 IPropertyStore 介面的編碼器。
使用 IPropertyStore 介面來設定編碼器。
呼叫 IMFTransform：：SetInputType 以在編碼器上設定未壓縮的視訊類型。
呼叫 IMFTransform：：GetOutputAvailableType 以從編碼器取得壓縮格式清單。 WMV 編碼器不會從這個方法傳回完整的媒體類型。媒體類型遺漏兩項資訊：
- 目標位元速率。
- 來自編碼器的私人編解碼器資料。
在編碼器上設定輸出類型之前，您必須將這兩個專案新增至媒體類型。
若要指定目標位元速率，請在媒體類型上設定 MF_MT_AVG_BITRATE 屬性。
將私人編解碼器資料新增至媒體類型，如下一節所述。
呼叫 IMFTransform：：SetOutputType 以在編碼器上設定壓縮媒體類型。

私人編解碼器資料

私人編解碼器資料是一種不透明的資料結構，您必須從 WMV 編碼器取得，並在編碼器上設定壓縮類型之前新增至壓縮類型。若要取得私人資料，您必須使用 IWMCodecPrivateData 介面，其記載于 Windows Media Format 11 SDK 中。

若要取得私人編解碼器資料，請執行下列步驟：

呼叫 IMFTransform：：GetOutputAvailableType 以從編碼器取得媒體類型。 (這是上一節的步驟 6。)
在媒體類型上設定 MF_MT_AVG_BITRATE 屬性， 以指定目標位元速率。
呼叫MFInitAMMediaTypeFromMFMediaType 函式，將媒體類型轉換成DMO_MEDIA_TYPE結構。
查詢 IWMCodecPrivateData 介面的編碼器。
呼叫 IWMCodecPrivateData：：SetPartialOutputType 方法，傳入轉換 的DMO_MEDIA_TYPE 結構。
呼叫 IWMCodecPrivateData：：GetPrivateData 方法兩次，一次取得私人資料的緩衝區大小，一次將資料複製到緩衝區。
藉由在類型上設定 MF_MT_USER_DATA 屬性，將私人資料新增至媒體類型。

下列擴充範例示範如何從未壓縮的視訊類型建立 WMV 壓縮格式：

#include <wmcodecdsp.h>
#include <Wmsdk.h>
#include <Dmo.h>
#include <mfapi.h>
#include <uuids.h>

#include <mfidl.h>
#include <mftransform.h>
#include <mferror.h>

#pragma comment(lib, "Msdmo")
#pragma comment(lib, "mfplat")
#pragma comment(lib, "mfuuid")
#pragma comment(lib, "strmiids")
#pragma comment(lib, "propsys")

HRESULT GetEncodedVideoType(
    IMFMediaType *pTypeIn, 
    REFGUID subtype,
    UINT32 TargetBitrate, 
    IPropertyStore *pEncoderProps, 
    IMFMediaType **ppEncodingType,
    DWORD mftEnumFlags = MFT_ENUM_FLAG_SYNCMFT
    );

HRESULT CreateVideoEncoder(REFGUID subtype, DWORD mftEnumFlags, IMFTransform **ppMFT);
HRESULT AddPrivateData(IMFTransform *pMFT, IMFMediaType *pTypeOut);
HRESULT CopyPropertyStore(IPropertyStore *pSrc, IPropertyStore *pDest);

//
// GetEncodedVideoType
// Given an uncompressed video type, finds a suitable WMV type.
//

HRESULT GetEncodedVideoType(
    IMFMediaType *pTypeIn,          // Uncompressed format
    REFGUID subtype,                // Compression format
    UINT32 TargetBitrate,           // Target bit rate
    IPropertyStore *pEncoderProps,  // Encoder properties (can be NULL)
    IMFMediaType **ppEncodingType,  // Receives the WMV type.
    DWORD mftEnumFlags              // MFTEnumEx flags
    )
{
    HRESULT hr = S_OK;

    IMFTransform *pMFT = NULL;
    IPropertyStore *pPropStore = NULL;
    IMFMediaType *pTypeOut = NULL;

    // Instantiate the encoder
    hr = CreateVideoEncoder(subtype, mftEnumFlags, &pMFT);

    // Copy the properties to the encoder.

    if (SUCCEEDED(hr))
    {
        if (pEncoderProps)
        {
            hr = pMFT->QueryInterface(IID_PPV_ARGS(&pPropStore));

            if (SUCCEEDED(hr))
            {
                hr = CopyPropertyStore(pEncoderProps, pPropStore);
            }
        }
    }

    // Set the uncompressed type.
    if (SUCCEEDED(hr))
    {
        hr = pMFT->SetInputType(0, pTypeIn, 0);
    }

    // Get the partial output type
    if (SUCCEEDED(hr))
    {
        hr = pMFT->GetOutputAvailableType(0, 0, &pTypeOut);
    }

    // Set the bit rate.
    // You must set this before getting the codec private data.

    if (SUCCEEDED(hr))
    {
        hr = pTypeOut->SetUINT32(MF_MT_AVG_BITRATE, TargetBitrate);   
    }

    if (SUCCEEDED(hr))
    {
        hr = AddPrivateData(pMFT, pTypeOut);
    }

    if (SUCCEEDED(hr))
    {
        hr = pMFT->SetOutputType(0, pTypeOut, 0);
    }

    if (SUCCEEDED(hr))
    {
        *ppEncodingType = pTypeOut;
        (*ppEncodingType)->AddRef();
    }

    SafeRelease(&pMFT);
    SafeRelease(&pPropStore);
    SafeRelease(&pTypeOut);
    return hr;
}

CreateVideoEncoder 函式會為指定的視訊子類型建立視訊編碼器，例如 MFVideoFormat_WMV3：

//
// CreateVideoEncoder
// Creates a video encoder for a specified video subtype.
//

HRESULT CreateVideoEncoder(
    REFGUID subtype,            // Encoding subtype.
    DWORD mftEnumFlags,         // Flags for MFTEnumEx
    IMFTransform **ppMFT        // Receives a pointer to the encoder.
    )
{
    HRESULT hr = S_OK;
    IMFTransform *pMFT = NULL;

    MFT_REGISTER_TYPE_INFO info;
    info.guidMajorType = MFMediaType_Video;
    info.guidSubtype = subtype;

    IMFActivate **ppActivates = NULL;    
    UINT32 count = 0;

    hr = MFTEnumEx(
        MFT_CATEGORY_VIDEO_ENCODER,
        mftEnumFlags | MFT_ENUM_FLAG_SORTANDFILTER,
        NULL,
        &info,
        &ppActivates,
        &count
        );

    if (count == 0)
    {
        hr = E_FAIL;
    }

    if (SUCCEEDED(hr))
    {
        hr = ppActivates[0]->ActivateObject(
            __uuidof(IMFTransform),
            (void**)&pMFT
            );
    }

    if (SUCCEEDED(hr))
    {
        *ppMFT = pMFT;
        (*ppMFT)->AddRef();
    }

    // Clean up

    for (DWORD i = 0; i < count; i++)
    {
        ppActivates[i]->Release();
    }
    CoTaskMemFree(ppActivates);
    SafeRelease(&pMFT);
    return hr;
}

AddPrivateData 函式會將私人編解碼器資料新增至壓縮類型：

//
// AddPrivateData
// Appends the private codec data to a media type.
//
// pMFT: The video encoder
// pTypeOut: A video type from the encoder's type list.
//
// The function modifies pTypeOut by adding the codec data.
//

HRESULT AddPrivateData(IMFTransform *pMFT, IMFMediaType *pTypeOut)
{
    HRESULT hr = S_OK;
    ULONG cbData = 0;
    BYTE *pData = NULL;

    IWMCodecPrivateData *pPrivData = NULL;

    DMO_MEDIA_TYPE mtOut = { 0 };

    // Convert the type to a DMO type.
    hr = MFInitAMMediaTypeFromMFMediaType(
        pTypeOut, 
        FORMAT_VideoInfo, 
        (AM_MEDIA_TYPE*)&mtOut
        );
    
    if (SUCCEEDED(hr))
    {
        hr = pMFT->QueryInterface(IID_PPV_ARGS(&pPrivData));
    }

    if (SUCCEEDED(hr))
    {
        hr = pPrivData->SetPartialOutputType(&mtOut);
    }

    //
    // Get the private codec data
    //

    // First get the buffer size.
    if (SUCCEEDED(hr))
    {
        hr = pPrivData->GetPrivateData(NULL, &cbData);
    }

    if (SUCCEEDED(hr))
    {
        pData = new BYTE[cbData];

        if (pData == NULL)
        {
            hr = E_OUTOFMEMORY;
        }
    }

    // Now get the data.
    if (SUCCEEDED(hr))
    {
        hr = pPrivData->GetPrivateData(pData, &cbData);
    }

    // Add the data to the media type.
    if (SUCCEEDED(hr))
    {
        hr = pTypeOut->SetBlob(MF_MT_USER_DATA, pData, cbData);
    }

    delete [] pData;
    MoFreeMediaType(&mtOut);
    SafeRelease(&pPrivData);
    return hr;
}

CopyPropertyStore 函式是協助程式函式，可將屬性從一個屬性存放區複製到另一個：

//
// CopyPropertyStore
// Helper function to copy properties from one property
// store to another property store.
//

HRESULT CopyPropertyStore(IPropertyStore *pSrc, IPropertyStore *pDest)
{
    HRESULT hr = S_OK;
    DWORD cProps = 0;

    PROPERTYKEY key;
    PROPVARIANT var;

    PropVariantInit(&var);

    hr = pSrc->GetCount(&cProps);

    if (SUCCEEDED(hr))
    {
        for (DWORD i = 0; i < cProps; i++)
        {
            hr = pSrc->GetAt(i, &key);

            if (FAILED(hr)) { break; }

            hr = pSrc->GetValue(key, &var);

            if (FAILED(hr)) { break; }

            hr = pDest->SetValue(key, var);

            if (FAILED(hr)) { break; }

            PropVariantClear(&var);
        }
    }

    PropVariantClear(&var);
    return hr;
}

具現化編碼器 MFT
Windows 媒體編碼器

設定 WMV 編碼器

私人編解碼器資料

意見反應

意見反應

其他資源

設定 WMV 編碼器

私人編解碼器資料

相關主題

意見反應

意見反應

其他資源