IWICMetadataQueryReader

メタデータクエリ式を使用して、デコーダーまたはその画像フレームからメタデータブロックおよびアイテムを取得するためのメソッドを公開します。

メタデータクエリリーダーは、メタデータクエリ式を使用して埋め込みメタデータにアクセスします。メタデータクエリ言語の詳細については、Metadata Query Language Overview を参照してください。

クエリリーダーの利点は、メタデータアイテムに単一のステップでアクセスできる点です。

クエリリーダーは、GetEnumerator メソッドを利用して、メタデータ階層全体をたどる手段も提供します。 ただし、IWICMetadataBlockReader および IWICMetadataReader の方が、より便利かつ低コストな方法を提供するため、このメソッドの使用は推奨されません。

例

次のコードは、クエリリーダーを取得し、それを使用してメタデータアイテムを取得する方法を示します。

// Get the query reader
if (SUCCEEDED(hr))
{
    hr = pFrameDecode->GetMetadataQueryReader(&pQueryReader);
}

if (SUCCEEDED(hr))
{
    hr = pQueryReader->GetMetadataByName(L"/app1/ifd/{ushort=18249}", &value);
    PropVariantClear(&value);
}

次のコードは、クエリリーダーを取得し、それを使用して入れ子になったメタデータブロックを取得する方法を示します。

// Get the query reader
if (SUCCEEDED(hr))
{
    hr = pFrameDecode->GetMetadataQueryReader(&pQueryReader);
}

if (SUCCEEDED(hr))
{
    // Get the embedded IFD reader
    hr = pQueryReader->GetMetadataByName(L"/app1/ifd", &value);
    if (value.vt == VT_UNKNOWN)
    {
        hr = value.punkVal->QueryInterface(IID_IWICMetadataQueryReader, (void **)&pEmbedReader);
    }
    PropVariantClear(&value); // Clear value for new query
}

メタデータクエリリーダーのコンテナー形式を取得します。

型: HRESULT

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

ルートメタデータブロックからの相対的な現在のパスを取得します。

型: HRESULT

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

wzNamespace に NULL を渡した場合、GetLocation は cchMaxLength を無視し、pcchActualLength が指す変数にパスを格納するために必要なバッファー長を返します。

クエリリーダーがメタデータ階層の最上位に対して相対的である場合は、1文字の文字列を返します。

クエリリーダーが入れ子になったメタデータブロックに対して相対的である場合、このメソッドは現在のクエリリーダーへのパスを返します。

メタデータクエリ式によって識別されるメタデータブロックまたはアイテムを取得します。

型: HRESULT

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

GetMetadataByName は、メタデータクエリ式を使用して埋め込みメタデータにアクセスします。メタデータクエリ言語の詳細については、Metadata Query Language Overview を参照してください。

同じクエリ式で表される複数のブロックまたはアイテムが存在する場合は、最初に見つかったメタデータブロックまたはアイテムが返されます。

メタデータ階層内の現在の相対位置にあるすべてのメタデータアイテムの列挙子を取得します。

型: HRESULT

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

取得される列挙子には、階層の現在のレベルにあるメタデータブロックおよびアイテムのクエリ文字列のみが含まれます。