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.
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 |
|
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk