IPortableDeviceResources::GetStream メソッド (portabledeviceapi.h)

  • [アーティクル]

GetStream メソッドは、デバイス上のオブジェクト内のコンテンツ データの読み取りまたは書き込みに使用する IStream インターフェイスを取得します。 取得したインターフェイスを使用すると、オブジェクト データの読み取りまたは書き込みを行うことができます。

構文

HRESULT GetStream(
  [in]      LPCWSTR        pszObjectID,
  [in]      REFPROPERTYKEY Key,
  [in]      const DWORD    dwMode,
  [in, out] DWORD          *pdwOptimalBufferSize,
  [out]     IStream        **ppStream
);

パラメーター

[in] pszObjectID

オブジェクトのオブジェクト ID を含む null で終わる文字列へのポインター。

[in] Key

読み取るリソースを指定する REFPROPERTYKEY 。 GetSupportedResources を呼び出すことで、すべてのオブジェクトのリソースのキーを取得できます。

[in] dwMode

次のいずれかのアクセス モード:

  • STGM_READ (読み取り専用アクセス)。
  • STGM_WRITE (書き込み専用アクセス)。
  • STGM_READWRITE (読み取り/書き込みアクセス)。

[in, out] pdwOptimalBufferSize

ppStream を使用してデータを読み書きするときに使用する最適なバッファー サイズの見積もりを指定する DWORD への省略可能なポインター。 この値をサポートするには、ドライバーが必要です。

[out] ppStream

IStream インターフェイス ポインターへのポインター。 このインターフェイスは、オブジェクトに対するデータの読み取りと書き込みに使用されます。 呼び出し元は、このインターフェイスが完了したら、このインターフェイスを解放する必要があります。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード 説明
S_OK
 メソッドが成功しました。
E_POINTER
 必要なポインター引数の少なくとも 1 つが NULL でした。

注釈

取得したストリームは、フォルダーの内容を再帰的に読み取ることができません。 オブジェクト内のすべてのリソースをコピーするには、[キー ] にWPD_RESOURCE_DEFAULT を指定 します。

オブジェクトがリソースをサポートしていない場合、このメソッドはエラーを返し、 ppStream は NULL になります。

アプリケーションでは、読み取り操作または書き込み操作にバッファーを割り当てるときに pdwOptimalBufferSize によって返されるバッファー サイズを使用する必要があります。

要件

要件 値
対象プラットフォーム Windows
ヘッダー portabledeviceapi.h
Library PortableDeviceGUIDs.lib

こちらもご覧ください

IPortableDeviceResources インターフェイス