IOCTL_DISK_SET_CLUSTER_INFO kode kontrol

Artikel
06/13/2023

Mengatur informasi kluster pada disk.

Untuk melakukan operasi ini, panggil fungsi DeviceIoControl dengan parameter berikut.

BOOL 
WINAPI 
DeviceIoControl( (HANDLE)       hDevice,         // handle to device 
                 IOCTL_DISK_SET_CLUSTER_INFO,    // dwIoControlCode
                 (LPVOID)       NULL,            // lpInBuffer 
                 (DWORD)        0,               // nInBufferSize 
                 (LPVOID)       lpOutBuffer,     // output buffer:GET_DISK_ATTRIBUTES
                 (DWORD)        nOutBufferSize,  // size of output buffer
                 (LPDWORD)      lpBytesReturned, // number of bytes returned
                 (LPOVERLAPPED) lpOverlapped );  // OVERLAPPED structure

Parameter

hDevice

Handel ke disk.

Untuk mengambil handel perangkat, panggil fungsi CreateFile .

dwIoControlCode

Kode kontrol untuk operasi.

Gunakan IOCTL_DISK_SET_CLUSTER_INFO untuk operasi ini.

lpInBuffer

Penunjuk ke struktur data DISK_CLUSTER_INFO yang berisi informasi kluster untuk disk.

nInBufferSize

Ukuran buffer input, dalam byte.

lpOutBuffer

Tidak digunakan dengan operasi ini. Atur ke NULL.

nOutBufferSize

Ukuran buffer output, dalam byte. Atur ke 0 (nol).

lpBytesReturned

Tidak digunakan dengan operasi ini. Atur ke NULL.

lpOverlapped

Penunjuk ke struktur YANG TUMPANG TINDIH .

Jika hDevice dibuka tanpa menentukan FILE_FLAG_OVERLAPPED, lpOverlapped diabaikan.

Jika hDevice dibuka dengan bendera FILE_FLAG_OVERLAPPED , operasi dilakukan sebagai operasi yang tumpang tindih (asinkron). Dalam hal ini, lpOverlapped harus menunjuk ke struktur TUMPANG TINDIH yang valid yang berisi handel ke objek peristiwa. Jika tidak, fungsi gagal dengan cara yang tidak dapat diprediksi.

Untuk operasi yang tumpang tindih, DeviceIoControl segera kembali, dan objek peristiwa disinyalir ketika operasi telah selesai. Jika tidak, fungsi tidak kembali sampai operasi selesai atau terjadi kesalahan.

Menampilkan nilai

Jika operasi berhasil diselesaikan, menunjukkan bahwa semua volume pada disk siap digunakan, DeviceIoControl mengembalikan nilai bukan nol.

Jika operasi gagal atau tertunda, DeviceIoControl mengembalikan nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tidak ada yang didukung
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Header	Ntdddisk.h

Lihat juga

DeviceIoControl
Kode Kontrol Manajemen Disk
DISK_CLUSTER_INFO
IOCTL_DISK_GET_CLUSTER_INFO

Bagikan melalui