デバイスでサポートされているレンダリング機能の取得

[アーティクル]
01/28/2024

Windowsレンダリング情報機能カテゴリ (WPD_FUNCTIONAL_CATEGORY_RENDERING_INFORMATION) をサポートするポータブルデバイスは、クエリを実行するとレンダリング情報を返します。レンダリング情報では、デバイスにコンテンツを書き込もうとするアプリケーションに課せられる要件と制限について説明します。

DeviceCapabilities.cpp モジュールの ListRenderingCapabilityInformation 関数、SupportsFunctionalCategory ヘルパー関数、および ReadProfileInformationProperties ヘルパー関数は、選択したデバイスのレンダリング機能の取得を示します。

アプリケーションは、次の表で説明するインターフェイスを使用して、デバイスでサポートされているレンダリング機能を取得できます。

インターフェイス	説明
IPortableDeviceContent インターフェイス	IPortableDeviceProperties インターフェイスへのアクセスを提供します。
IPortableDeviceProperties インターフェイス	プロパティ固有のメソッドへのアクセスを提供します。
IPortableDeviceKeyCollection インターフェイス	指定されたプロファイルのプロパティキーを格納するために使用されます。
IPortableDeviceValues インターフェイス	使用すると、指定されたプロファイルのプロパティ値が格納されます。
IPortableDeviceCapabilities インターフェイス	使用すると、指定されたプロファイルのプロパティ値が格納されます。
IPortableDevicePropVariantCollection インターフェイス	使用すると、指定されたプロファイルのプロパティ値が格納されます。
IPortableDeviceValuesCollection インターフェイス	使用すると、指定されたプロファイルのプロパティ値が格納されます。

サンプルアプリケーションによって実行される最初のタスクの 1 つは、選択したデバイスがレンダリング機能を一覧表示できるかどうかを判断することです。 SupportsFunctionalCategory ヘルパー関数は、ListRenderingCapabilityInformation ヘルパー関数を呼び出し、WPD_FUNCTIONAL_CATEGORY_RENDERING_INFORMATIONを 2 番目の引数として渡すことによって、これが当てはめるかどうかを判断します。

HRESULT hr = S_OK;
CComPtr<IPortableDeviceCapabilities>          pCapabilities;
CComPtr<IPortableDevicePropVariantCollection> pRenderingInfoObjects;
CComPtr<IPortableDeviceValuesCollection>      pRenderingInfoProfiles;
CAtlStringW                                   strRenderingInfoObjectID;
if (SupportsFunctionalCategory(pDevice, WPD_FUNCTIONAL_CATEGORY_RENDERING_INFORMATION) == FALSE)
{
    printf("This device does not support device rendering information to display\n");
    return;
}

デバイスがレンダリング機能を一覧表示できる場合、次の手順では 、IPortableDeviceCapabilities オブジェクトを取得し、 GetFunctionalObjects メソッドを呼び出してレンダリング情報オブジェクトのオブジェクト識別子を取得します。

HRESULT hr = S_OK;
CComPtr<IPortableDeviceCapabilities>          pCapabilities;
CComPtr<IPortableDevicePropVariantCollection> pRenderingInfoObjects;
CComPtr<IPortableDeviceValuesCollection>      pRenderingInfoProfiles;
CAtlStringW                                   strRenderingInfoObjectID;
hr = pDevice->Capabilities(&pCapabilities);
if (FAILED(hr))
{
    printf("! Failed to get IPortableDeviceCapabilities from IPortableDevice, hr = 0x%lx\n",hr);
}

// Get the functional object identifier for the rendering information object
if (SUCCEEDED(hr))
{
    hr = pCapabilities->GetFunctionalObjects(WPD_FUNCTIONAL_CATEGORY_RENDERING_INFORMATION, &pRenderingInfoObjects);
    if (FAILED(hr))
    {
        printf("! Failed to get functional objects, hr = 0x%lx\n", hr);
    }
}

次の手順では、文字列変数 (strRenderingInfoObjectID) で取得したばかりのレンダリング情報オブジェクト識別子を格納し、ReadProfileInformationProperties ヘルパー関数を呼び出します。 (変数 strRenderingInfoObjectID は、ヘルパー関数に 2 番目の引数として渡されます)。

HRESULT hr = S_OK;
CComPtr<IPortableDeviceCapabilities>          pCapabilities;
CComPtr<IPortableDevicePropVariantCollection> pRenderingInfoObjects;
CComPtr<IPortableDeviceValuesCollection>      pRenderingInfoProfiles;
CAtlStringW                                   strRenderingInfoObjectID;
if (SUCCEEDED(hr))
{
    PROPVARIANT pv = {0};
    PropVariantInit(&pv);
    hr = pRenderingInfoObjects->GetAt(0, &pv);
    if ((SUCCEEDED(hr))    &&
        (pv.vt== VT_LPWSTR) )
    {
        strRenderingInfoObjectID = pv.pwszVal;
    }
    else
    {
        printf("! Failed to get first rendering object's identifier, hr = 0x%lx\n", hr);
    }

    PropVariantClear(&pv);
}

if (SUCCEEDED(hr))
{
    hr = ReadProfileInformationProperties(pDevice,
                                          strRenderingInfoObjectID,
                                          &pRenderingInfoProfiles);
    // Error output statements are performed by the helper function, so they
    // are omitted here.
}

ヘルパー関数によって実行される最初のタスクの 1 つは、コンテンツ固有のメソッドへのアクセスに使用する IPortableDeviceContent オブジェクトを取得することです。

HRESULT hr = S_OK;
CComPtr<IPortableDeviceValuesCollection> pRenderingInfoProfiles;
CComPtr<IPortableDeviceContent>          pContent;
CComPtr<IPortableDeviceProperties>       pProperties;
CComPtr<IPortableDeviceKeyCollection>    pPropertiesToRead;
CComPtr<IPortableDeviceValues>           pObjectProperties;
if (SUCCEEDED(hr))
{
    hr = pDevice->Content(&pContent);
    if (FAILED(hr))
    {
        printf("! Failed to get IPortableDeviceContent from IPortableDevice, hr = 0x%lx\n",hr);
    }
}

次に、ヘルパー関数は、プロパティ固有のメソッドへのアクセスに使用する IPortableDeviceProperties オブジェクトを取得します。

HRESULT hr = S_OK;
CComPtr<IPortableDeviceValuesCollection> pRenderingInfoProfiles;
CComPtr<IPortableDeviceContent>          pContent;
CComPtr<IPortableDeviceProperties>       pProperties;
CComPtr<IPortableDeviceKeyCollection>    pPropertiesToRead;
CComPtr<IPortableDeviceValues>           pObjectProperties;
if (SUCCEEDED(hr))
{
    hr = pContent->Properties(&pProperties);
    if (FAILED(hr))
    {
        printf("! Failed to get IPortableDeviceProperties from IPortableDevice, hr = 0x%lx\n",hr);
    }
}

次の手順では、レンダリング情報のプロパティキーが格納される IPortableDeviceKeyCollection オブジェクトを作成します。オブジェクトが作成されると、 IPortableDeviceKeyCollection::Add メソッドが呼び出され、必要なキーが追加されます。 (これらのキーを追加して、後続の手順で対応するレンダリングプロファイルを取得できるようにする必要があります)。

HRESULT hr = S_OK;
CComPtr<IPortableDeviceValuesCollection> pRenderingInfoProfiles;
CComPtr<IPortableDeviceContent>          pContent;
CComPtr<IPortableDeviceProperties>       pProperties;
CComPtr<IPortableDeviceKeyCollection>    pPropertiesToRead;
CComPtr<IPortableDeviceValues>           pObjectProperties;
hr = CoCreateInstance(CLSID_PortableDeviceKeyCollection,
                      NULL,
                      CLSCTX_INPROC_SERVER,
                      IID_IPortableDeviceKeyCollection,
                      (VOID**) &pPropertiesToRead);
if (SUCCEEDED(hr))
{
    // Populate the IPortableDeviceKeyCollection with the keys we wish to read.
    // NOTE: We are not handling any special error cases here so we can proceed with
    // adding as many of the target properties as we can.
    if (pPropertiesToRead != NULL)
    {
        HRESULT hrTemp = S_OK;
        hrTemp = pPropertiesToRead->Add(WPD_RENDERING_INFORMATION_PROFILES);
        if (FAILED(hrTemp))
        {
            printf("! Failed to add WPD_RENDERING_INFORMATION_PROFILES to IPortableDeviceKeyCollection, hr= 0x%lx\n", hrTemp);
        }
    }
}

次の手順では、 IPortableDeviceProperties::GetValues メソッドを呼び出して、デバイスドライバーからプロパティ値を取得します。

HRESULT hr = S_OK;
CComPtr<IPortableDeviceValuesCollection> pRenderingInfoProfiles;
CComPtr<IPortableDeviceContent>          pContent;
CComPtr<IPortableDeviceProperties>       pProperties;
CComPtr<IPortableDeviceKeyCollection>    pPropertiesToRead;
CComPtr<IPortableDeviceValues>           pObjectProperties;
if (SUCCEEDED(hr))
{
    hr = pProperties->GetValues(wszFunctionalObjectID, // The object whose properties we are reading
                                pPropertiesToRead,     // The properties we want to read
                                &pObjectProperties);   // Driver supplied property values for the specified object
    if (FAILED(hr))
    {
        printf("! Failed to get all properties for object '%ws', hr= 0x%lx\n", wszFunctionalObjectID, hr);
    }
}

次の手順では、レンダリング情報プロファイルを取得し、ppRenderingInfoProfiles 引数に格納します。

HRESULT hr = S_OK;
CComPtr<IPortableDeviceValuesCollection> pRenderingInfoProfiles;
CComPtr<IPortableDeviceContent>          pContent;
CComPtr<IPortableDeviceProperties>       pProperties;
CComPtr<IPortableDeviceKeyCollection>    pPropertiesToRead;
CComPtr<IPortableDeviceValues>           pObjectProperties;
if (SUCCEEDED(hr))
{
    hr = pObjectProperties->GetIPortableDeviceValuesCollectionValue(WPD_RENDERING_INFORMATION_PROFILES,
                                                                    &pRenderingInfoProfiles);
    if (FAILED(hr))
    {
        printf("! Failed to get WPD_RENDERING_INFORMATION_PROFILES from rendering information, hr= 0x%lx\n",  hr);
    }
}

// QueryInterface the interface into the out-going parameters.
if (SUCCEEDED(hr))
{
    hr = pRenderingInfoProfiles->QueryInterface(IID_PPV_ARGS(ppRenderingInfoProfiles));
    if (FAILED(hr))
    {
        printf("! Failed to QueryInterface for IPortableDeviceValuesCollection (Rendering information profiles), hr= 0x%lx\n",  hr);
    }
}

ヘルパー関数がWPD_RENDERING_INFORMATION_PROFILESプロパティを読み取った後、レンダリングプロファイルが表示されます。これらのプロファイルは、DisplayRenderingProfile ヘルパー関数によって表示されます。

void DisplayRenderingProfile(
    IPortableDeviceValues* pProfile)
{
    HRESULT hr = S_OK;
    if (pProfile == NULL)
    {
        return;
    }

    if (SUCCEEDED(hr))
    {
        DWORD dwTotalBitrate    = 0;
        DWORD dwChannelCount    = 0;
        DWORD dwAudioFormatCode = 0;
        GUID  guidFormat        = WPD_OBJECT_FORMAT_UNSPECIFIED;

        // Display WPD_MEDIA_TOTAL_BITRATE
        hr = pProfile->GetUnsignedIntegerValue(WPD_MEDIA_TOTAL_BITRATE, &dwTotalBitrate);
        if (SUCCEEDED(hr))
        {
            printf("Total Bitrate: %d\n", dwTotalBitrate);
        }

        // If we fail to read the total bitrate as a single value, then it must be
        // a valid value set.  (i.e. returning IPortableDeviceValues as the value which
        // contains properties describing the valid values for this property.)
        if (hr == DISP_E_TYPEMISMATCH)
        {
            CComPtr<IPortableDeviceValues> pExpectedValues;
            hr = pProfile->GetIPortableDeviceValuesValue(WPD_MEDIA_TOTAL_BITRATE, &pExpectedValues);
            if (SUCCEEDED(hr))
            {
                printf("Total Bitrate: ");
                DisplayExpectedValues(pExpectedValues);
            }
        }

        // If we are still a failure here, report the error
        if (FAILED(hr))
        {

            printf("! Failed to get WPD_MEDIA_TOTAL_BITRATE from rendering profile, hr = 0x%lx\n",hr);
        }

        // Display WPD_AUDIO_CHANNEL_COUNT
        hr = pProfile->GetUnsignedIntegerValue(WPD_AUDIO_CHANNEL_COUNT, &dwChannelCount);
        if (SUCCEEDED(hr))
        {
            printf("Channel Count: %d\n", dwChannelCount);
        }
        else
        {
            printf("! Failed to get WPD_AUDIO_CHANNEL_COUNT from rendering profile, hr = 0x%lx\n",hr);
        }

        // Display WPD_AUDIO_FORMAT_CODE
        hr = pProfile->GetUnsignedIntegerValue(WPD_AUDIO_FORMAT_CODE,   &dwAudioFormatCode);
        if (SUCCEEDED(hr))
        {
            printf("Audio Format Code: %d\n", dwAudioFormatCode);
        }
        else
        {
            printf("! Failed to get WPD_AUDIO_FORMAT_CODE from rendering profile, hr = 0x%lx\n",hr);
        }

        // Display WPD_OBJECT_FORMAT
        hr = pProfile->GetGuidValue(WPD_OBJECT_FORMAT, &guidFormat);
        if (SUCCEEDED(hr))
        {
            printf("Object Format: %ws\n", (LPWSTR)CComBSTR(guidFormat));
        }
        else
        {
            printf("! Failed to get WPD_OBJECT_FORMAT from rendering profile, hr = 0x%lx\n",hr);
        }
    }
}

レンダリングプロファイルは静的であるため、アプリケーションはプロファイルを読み取ってローカルに保存することを選択できます (データが必要になるたびにデバイスにアクセスする代わりに)。

IPortableDevice インターフェイス
IPortableDeviceCapabilities インターフェイス
IPortableDeviceContent インターフェイス
IPortableDeviceKeyCollection インターフェイス
IPortableDevicePropVariantCollection インターフェイス
IPortableDeviceValuesCollection インターフェイス
プログラミングガイド

次の方法で共有

デバイスでサポートされているレンダリング機能の取得

フィードバック

その他のリソース

次の方法で共有

デバイスでサポートされているレンダリング機能の取得

関連トピック

フィードバック

その他のリソース