共用方式為

WICHeifHdrProperties 列舉 (wincodec.h)

  • 發行項

指定高效能影像格式的 HDR 屬性， (HEIF) 影像。

Syntax

typedef enum WICHeifHdrProperties {
  WICHeifHdrMaximumLuminanceLevel = 0x1,
  WICHeifHdrMaximumFrameAverageLuminanceLevel = 0x2,
  WICHeifHdrMinimumMasteringDisplayLuminanceLevel = 0x3,
  WICHeifHdrMaximumMasteringDisplayLuminanceLevel = 0x4,
  WICHeifHdrCustomVideoPrimaries = 0x5,
  WICHeifHdrProperties_FORCE_DWORD = 0x7fffffff
} ;

常數

 
WICHeifHdrMaximumLuminanceLevel
值： 0x1
[VT_UI2]指定 Nits 中內容的最大亮度等級。
WICHeifHdrMaximumFrameAverageLuminanceLevel
值： 0x2
[VT_UI2]指定 Nits 中內容的平均每一畫面格亮度上限。
WICHeifHdrMinimumMasteringDisplayLuminanceLevel
值： 0x3
[VT_UI2]指定在 Nits 撰寫內容之顯示的最大亮度。
WICHeifHdrMaximumMasteringDisplayLuminanceLevel
值： 0x4
[VT_UI2]指定在 Nits 撰寫內容之顯示的最大亮度。
WICHeifHdrCustomVideoPrimaries
值： 0x5
[VT_BLOB]指定視訊媒體類型的自訂色彩主要。 此屬性的值是 MT_CUSTOM_VIDEO_PRIMARIES結構，以位元組陣列的形式傳回 (VT_BLOB) 。
WICHeifHdrProperties_FORCE_DWORD
值： 0x7fffffff

備註

使用 IWicMetadataReader：：GetValue 來擷取這個列舉所指定的屬性值。 使用 GUID CLSID_WICMetadataReader具現化 IWicMetadataReader 實例。 呼叫 IWicMetadataReader：：GetMetadataFormat ，並確認值 GUID_MetadataFormatHeifHDR 確認元數據格式為 HEIF HDR 元數據。

並非所有 HEIF HDR 影像都會有檔案中的所有屬性，因此只有元數據讀取器才會公開可用的屬性。

using namespace winrt;

std::optional<uint32_t> GetMaximumLuminanceLevelFromMetadataReader(_In_ IWICMetadataReader* metadataReader)
{
    std::optional<uint32_t> result;
    GUID metadataFormat;

    // Retrieve the format of the metadata used by this IWICMetadataReader
    check_hresult(metadataReader->GetMetadataFormat(&metadataFormat));

    // This function only handles HEIF HDR metadata
    if (metadataFormat != GUID_MetadataFormatHeifHDR)
    {
        throw_hresult(E_INVALIDARG);
    }

    PROPVARIANT variantId = {};
    PROPVARIANT variantValue = {};

    variantId.vt = VT_UI4;
    variantId.uiVal = WICHeifHdrMaximumLuminanceLevel;
    if (SUCCEEDED(metadataReader->GetValue(nullptr, &variantId, &variantValue)))
    {
        if (variantValue.vt == VT_UI4)
        {
            result = variantValue.uiVal;
        }
        PropVariantClear(&variantValue);
    }

    return result;
}

規格需求

需求 值
最低支援的用戶端 Windows 10 版本 1903 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 版本 1903 [僅限傳統型應用程式]
標頭 wincodec.h