Fungsi ClfsCreateScanContext (wdm.h)

  • Artikel

Rutinitas ClfsCreateScanContext membuat konteks pemindaian yang dapat digunakan untuk mengulangi kontainer log CLFS tertentu.

Sintaks

CLFSUSER_API NTSTATUS ClfsCreateScanContext(
  [in]      PLOG_FILE_OBJECT   plfoLog,
  [in]      ULONG              cFromContainer,
  [in]      ULONG              cContainers,
  [in]      CLFS_SCAN_MODE     eScanMode,
  [in, out] PCLFS_SCAN_CONTEXT pcxScan
);

Parameter

[in] plfoLog

Penunjuk ke struktur LOG_FILE_OBJECT yang mewakili aliran CLFS. Konteks pemindaian dibuat untuk log yang menyediakan penyimpanan yang mendasar untuk aliran tersebut. Pemanggil sebelumnya mendapatkan pointer ini dengan memanggil ClfsCreateLogFile.

[in] cFromContainer

Indeks kontainer pertama yang akan dipindai. Kontainer diindeks mulai dari nol.

[in] cContainers

Jumlah kontainer yang akan dipindai dengan setiap panggilan ke ClfsScanLogContainers.

[in] eScanMode

Sekumpulan bendera yang menentukan apakah konteks pemindaian disiapkan untuk memindai maju atau mundur dan apakah konteks pemindaian harus diinisialisasi ulang. Tiga bendera berikut tersedia untuk pemanggil rutinitas ini.

Nilai Makna
CLFS_SCAN_FORWARD Siapkan konteks pemindaian untuk pemindaian ke arah depan. Misalnya, jika kontainer 5 adalah kontainer yang terakhir dipindai dan cContainers adalah 2, pemindaian maju akan mengembalikan deskriptor untuk kontainer 6 dan 7.
CLFS_SCAN_BACKWARD Siapkan konteks pemindaian untuk pemindaian ke arah mundur. Misalnya, jika kontainer 5 adalah kontainer dan cContainer yang terakhir dipindai adalah 2, pemindaian mundur akan mengembalikan deskriptor untuk kontainer 4 dan 3.
CLFS_SCAN_INIT Menginisialisasi ulang konteks pemindaian. Lain kali ClfsScanLogContainers dipanggil, clfsScanLogContainers akan bertingkah seolah-olah dipanggil untuk pertama kalinya setelah pembuatan konteks pemindaian.
 

Jika pcxScan menunjuk ke struktur CLFS_SCAN_CONTEXT yang sedang diteruskan ke rutinitas ini untuk pertama kalinya, salah satu bendera arah (CLFS_SCAN_FORWARD atau CLFS_SCAN_BACKWARD) harus diatur. Bendera CLFS_SCAN_INIT tidak boleh diatur.

Jika pcxScan menunjuk ke struktur CLFS_SCAN_CONTEXT yang telah diteruskan ke rutinitas ini sebelumnya, bendera CLFS_SCAN_INIT harus diatur. Selain itu, satu dan hanya satu bendera arah (CLFS_SCAN_FORWARD atau CLFS_SCAN_BACKWARD) yang harus diatur.

[in, out] pcxScan

Penunjuk ke struktur CLFS_SCAN_CONTEXT yang dialokasikan penelepon yang anggotanya diinisialisasi oleh rutinitas ini. Struktur ini kemudian diteruskan ke ClfsScanLogContainers.

Nilai kembali

ClfsCreateScanContext mengembalikan STATUS_SUCCESS jika berhasil; jika tidak, ia mengembalikan salah satu kode kesalahan di Ntstatus.h.

Keterangan

Untuk penjelasan tentang konsep dan terminologi CLFS, lihat Sistem File Log Umum.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows Server 2003 R2, Windows Vista, dan versi Windows yang lebih baru.
Target Platform Desktop
Header wdm.h (termasuk Wdm.h)
Pustaka Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

Lihat juga

ClfsScanLogContainers