IAsyncReader::SyncRead
SyncRead メソッドは、同期読み取りを実行する。メソッドは、要求が完了するまでブロックする。ファイルの位置とバッファ アドレスは、アラインメントする必要はない。要求がアラインメントされていない場合、メソッドはバッファリングされた読み取り処理を実行する。
構文
HRESULT SyncRead(
LONGLONG llPosition,
LONG lLength,
BYTE *pBuffer
);
パラメータ
llPosition
[in] 読み取りを開始するバイト オフセットを指定する。値がファイルの末尾を超えると、メソッドは失敗する。
lLength
[in] 読み取るバイト数を指定する。
pBuffer
[out] データを受け取るバッファへのポインタ。
戻り値
HRESULT 値を返す。可能な値は次のとおりである。
戻りコード | 説明 |
S_FALSE | 取得したバイトの数が要求されたバイトの数より少ない (ファイルの末尾に達したと考えられる)。 |
S_OK | 成功。 |
注意
このメソッドは、フィルタが停止していても動作する。
参照