CcCopyRead 函式 （ntifs.h）

CcCopyRead 例程會將數據從快取的檔案複製到用戶緩衝區。

語法

BOOLEAN CcCopyRead(
  [in]  PFILE_OBJECT     FileObject,
  [in]  PLARGE_INTEGER   FileOffset,
  [in]  ULONG            Length,
  [in]  BOOLEAN          Wait,
  [out] PVOID            Buffer,
  [out] PIO_STATUS_BLOCK IoStatus
);

參數

[in] FileObject

要從中讀取數據的快取檔案之檔案物件的指標。

[in] FileOffset

變數的指標，指定快取檔案內的起始位元組位移。

[in] Length

要讀取之數據的位元組長度。

[in] Wait

如果呼叫端可以放入等候狀態，直到複製所有數據，FALSE，請將 設定為 TRUE。

[out] Buffer

要複製數據之緩衝區的指標。

[out] IoStatus

呼叫端配置的結構的指標，可接收最終完成狀態和作業的相關信息。 如果並非所有的數據都成功複製，IoStatus.Information 包含實際複製的位元組數目。

傳回值

如果成功複製數據，CcCopyRead 例程會傳 回 TRUE true，否則 FALSE。

言論

如果 Wait TRUE，CcCopyRead 保證可以完成複製要求，並傳回 TRUE。 如果快取檔案的必要頁面已存在於記憶體中，則會立即複製數據，而且不會發生封鎖。 如果任何需要的頁面都不是常駐頁面，則呼叫端會進入等候狀態，直到所有必要頁面都已進入居民狀態，而且可以複製數據。

如果 WaitFALSE，CcCopyRead 會拒絕封鎖，如果快取檔案的必要頁面尚未存在於記憶體中，則會傳回 FALSE。

FileOffset 加上 Length 必須小於或等於快取檔案的大小，否則會發生判斷提示失敗。

如果發生任何失敗，CcCopyRead 會引發該特定失敗的狀態例外狀況。 例如，如果發生集區配置失敗，CcCopyRead 引發STATUS_INSUFFICIENT_RESOURCES例外狀況;如果發生 I/O 錯誤，CcCopyRead 會引發 I/O 錯誤的狀態例外狀況。 因此，若要控制是否發生失敗，驅動程式應該在 try-finally 語句中包裝對 try-except 或 try-finally 語句中的 CcCopyRead 呼叫。

若要快取檔案，請使用 CcInitializeCacheMap。

要求

另請參閱

CcFastCopyRead

CcInitializeCacheMap

CcReadAhead

CcScheduleReadAhead

CcSetAdditionalCacheAttributes

CcSetReadAheadGranularity