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 を返します。 有効な値を次の表に示しますが、これ以外にもあります。
リターン コード | 説明 |
---|---|
|
シーク ポインターが正常に調整されました。 |
|
plibNewPosition が読み取られないため、[out] パラメーター plibNewPosition が無効なメモリを指していることを示します。 |
|
dwUnits または dwOrigin パラメーターに無効な値が含まれているか、dlibMove パラメーターに無効なオフセット値が含まれています。 たとえば、シーク ポインターの結果は負のオフセット値です。 |
要件
サポートされている最小のクライアント | Windows 8 [デスクトップ アプリ |UWP アプリ] |
サポートされている最小のサーバー | サポートなし |
対象プラットフォーム | Windows |
ヘッダー | portabledeviceapi.h |
Library | PortableDeviceGUIDs.lib |