IXpsOMImageResource

画像リソースへの IStream インターフェイスを提供します。

次のコード例は、このインターフェイスのインスタンスを作成する方法を示しています。

IXpsOMImageResource    *newInterface;
// The following values are defined outside of 
// this example.
//  IStream            *acquiredStream;
//  XPS_IMAGE_TYPE     contentType;
//  IOpcPartUri        *partUri;
    
// Note the implicit requirement that CoInitializeEx 
//  has previously been called from this thread.

hr = CoCreateInstance(
    __uuidof(XpsOMObjectFactory),
    NULL,
    CLSCTX_INPROC_SERVER,
    _uuidof(IXpsOMObjectFactory),
    reinterpret_cast<LPVOID*>(&xpsFactory)
    );

if (SUCCEEDED(hr))
{
    // The partUriString and acquiredStream variables 
    //   are defined outside of this example.
    hr = xpsFactory->CreatePartUri(partUriString, &partUri);
    if (SUCCEEDED(hr))
    {
        hr = xpsFactory->CreateImageResource (
            acquiredStream,
            contentType,
            partUri,
            &newInterface);
        if (SUCCEEDED(hr))
        {
            // use newInterface

            newInterface->Release();
        }
        partUri->Release();
    }
    xpsFactory->Release();
}
else
{
    // evaluate HRESULT error returned in hr
}

このリソースに関連付けられているストリームの、新しい読み取り専用のコピーを取得します。(IXpsOMImageResource.GetStream)

メソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。XPS ドキュメント API の戻り値については、XPS Document Errors を参照してください。

このメソッドは Packaging API を呼び出します。Packaging API の戻り値については、Packaging Errors を参照してください。

このメソッドが返す IStream オブジェクトは、E_PENDING エラーを返す場合があります。これは、ストリームの長さがまだ確定していないことを示します。この動作は、標準の IStream オブジェクトの動作とは異なります。

このメソッドは、stream で返されるストリームを作成するために、ストリームの Clone メソッドを呼び出します。そのため、このメソッドのパフォーマンスは、ストリームの Clone メソッドのパフォーマンスに依存します。

このリソースに関連付ける読み取り専用ストリームを設定します。(IXpsOMImageResource.SetContent)

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

呼び出し側のメソッドは、このストリームをシングルスレッドアパートメント (STA) モデルのオブジェクトとして扱い、ストリームインターフェイスのいずれのメソッドにも再入しないようにする必要があります。

GetStream はこのメソッドで設定されたストリームのクローンを取得するため、指定するストリームには効率的なクローン作成メソッドが必要です。クローン作成メソッドが非効率なストリームは、GetStream のパフォーマンスを低下させます。

画像リソースの種類を取得します。

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