IPortableDeviceUnitsStream::SeekInUnits メソッド (portabledeviceapi.h)

SeekInUnits メソッドは、代替単位に基づいてストリームに対してシークを実行します。

構文

HRESULT SeekInUnits(
  [in]            LARGE_INTEGER    dlibMove,
  [in]            WPD_STREAM_UNITS units,
  [in]            DWORD            dwOrigin,
  [out, optional] ULARGE_INTEGER   *plibNewPosition
);

パラメーター

[in] dlibMove

dwOrigin パラメーターで示される場所に追加する変位。 変位の単位は 単位で指定されます。 dwOrigin がSTREAM_SEEK_SET場合、これは符号付き値ではなく符号なし値として解釈されます。

[in] units

dlibMove パラメーターと plibNewPosition パラメーターの単位。 詳細については、「 WPD_STREAM_UNITS 」を参照してください。

[in] dwOrigin

dlibMove で指定された変位の原点。 配信元には、ファイルの先頭 (STREAM_SEEK_SET)、現在のシーク ポインター (STREAM_SEEK_CUR)、またはファイルの末尾 (STREAM_SEEK_END) を指定できます。 値の詳細については、「 STREAM_SEEK 列挙」を参照してください。

[out, optional] plibNewPosition

このメソッドがストリームの先頭から新しいシーク ポインターの値を書き込む場所へのポインター。 単位は単位で指定されます。 このポインターは NULL に設定できます。 この場合、このメソッドは新しいシーク ポインターを提供しません。

戻り値

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

リターン コード	説明
S_OK	シーク ポインターが正常に調整されました。
STG_E_INVALIDPOINTER	plibNewPosition が読み取られないため、[out] パラメーター plibNewPosition が無効なメモリを指していることを示します。
STG_E_INVALIDFUNCTION	dwUnits または dwOrigin パラメーターに無効な値が含まれているか、dlibMove パラメーターに無効なオフセット値が含まれています。 たとえば、シーク ポインターの結果は負のオフセット値です。

要件

サポートされている最小のクライアント	Windows 8 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	portabledeviceapi.h
Library	PortableDeviceGUIDs.lib

関連項目

IPortableDeviceUnitsStream

WPD_STREAM_UNITS