IOCTL_SCSI_MINIPORT_NVCACHE IOCTL (ntddscsi.h)

Artikel
02/29/2024

Operasi NV Cache Management yang ditentukan di sini dapat dipanggil oleh kode aplikasi mode pengguna yang berjalan dengan hak istimewa administrator, menggunakan DeviceIoControl dan kode kontrol IOCTL_SCSI_MINIPORT . Atau, pemanggil dapat berupa kode driver mode kernel menggunakan IoBuildDeviceIoControlRequest dan kode kontrol IOCTL_SCSI_MINIPORT.

Permintaan fungsi NV Cache Management ditentukan dalam bidang dalam struktur NVCACHE_REQUEST_BLOCK . Input ke IOCTL_SCSI_MINIPORT adalah struktur data yang ditentukan pengguna yang berisi struktur SRB_IO_CONTROL diikuti oleh struktur NVCACHE_REQUEST_BLOCK . Data khusus fungsi tambahan mungkin secara opsional mengikuti struktur NVCACHE_REQUEST_BLOCK .

Antarmuka yang digunakan untuk fungsionalitas NV Cache Management terdiri dari dua lapisan. Lapisan pertama adalah antarmuka antara pemanggil dan driver port, yang didefinisikan oleh IOCTL_SCSI_MINIPORT. Lapisan kedua adalah antarmuka antara pemanggil dan perangkat, yang ditentukan oleh spesifikasi ATA8-ACS dan IOCTL_SCSI_MINIPORT_NVCACHE. API untuk kode aplikasi mode pengguna adalah antarmuka DeviceIoControl. API untuk kode driver mode kernel adalah antarmuka IoBuildDeviceIoControlRequest , yang menggunakan IOCTL_SCSI_MINIPORT.

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer input

Buffer di Irp-AssociatedIrp.SystemBuffer> berisi struktur SRB_IO_CONTROL dengan bidang Tanda Tangan diatur ke "HYBRDISK", dan bidang ControlCode diatur ke IOCTL_SCSI_MINIPORT_NVCACHE. Struktur NVCACHE_REQUEST_BLOCK segera mengikuti struktur SRB_IO_CONTROL . Setiap buffer data fungsi-spesifik opsional segera mengikuti struktur NVCACHE_REQUEST_BLOCK .

Panjang buffer input

Parameters.DeviceIoControl.InputBufferLength menunjukkan ukuran, dalam byte, dari semua data input: SRB_IO_CONTROL, NVCACHE_REQUEST_BLOCK, dan buffer data khusus fungsi digabungkan. Kehadiran atau tidak adanya buffer data ditunjukkan oleh bidang NVCACHE_REQUEST_BLOCK****DataBufSize .

Buffer output

Struktur SRB_IO_CONTROLSRB_IO_CONTROL**]() dan NVCACHE_REQUEST_BLOCK yang diperbarui, serta buffer data khusus fungsi opsional, dikembalikan ke buffer di Irp-AssociatedIrp.SystemBuffer>.