IOCTL_DISK_GET_CLUSTER_INFO kode kontrol

Mengambil atribut perangkat disk yang ditentukan.

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

BOOL 
WINAPI 
DeviceIoControl( (HANDLE)       hDevice,         // handle to device 
                 IOCTL_DISK_GET_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_GET_CLUSTER_INFO untuk operasi ini.

lpInBuffer

Tidak digunakan dengan operasi ini. Atur ke NULL.

nInBufferSize

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

lpOutBuffer

Penunjuk ke buffer yang menerima struktur data DISK_CLUSTER_INFO .

nOutBufferSize

Ukuran buffer output, dalam byte.

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.

Mengembalikan 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_SET_CLUSTER_INFO