IOCTL_DISK_SET_CLUSTER_INFO控制項程式碼
設定磁片上的叢集資訊。
若要執行這項作業，請使用下列參數呼叫 DeviceIoControl 函 式。
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
參數
-
hDevice
-
磁片的控制碼。
若要擷取裝置控制碼，請呼叫 CreateFile 函式。
-
dwIoControlCode
-
作業的控制程式代碼。
使用此作業 IOCTL_DISK_SET_CLUSTER_INFO 。
-
lpInBuffer
-
包含磁片叢集資訊的 DISK_CLUSTER_INFO 資料結構的指標。
-
nInBufferSize
-
輸入緩衝區的大小，以位元組為單位。
-
lpOutBuffer
-
未與這項作業搭配使用。 設定為 Null。
-
nOutBufferSize
-
輸出緩衝區的大小 (以位元組為單位)。 設定為 0 (零) 。
-
lpBytesReturned
-
未與這項作業搭配使用。 設定為 Null。
-
lpOverlapped
-
重迭結構的指標。
如果 開啟 hDevice 而不指定 FILE_FLAG_OVERLAPPED，則會忽略 lpOverlapped 。
如果 hDevice 是以 FILE_FLAG_OVERLAPPED 旗標開啟，則會以重迭的 (非同步) 作業來執行。 在此情況下， lpOverlapped 必須指向包含事件物件控制碼的有效 OVERLAPPED 結構。 否則，函式會以無法預期的方式失敗。
針對重迭的作業， DeviceIoControl 會立即傳回，而且當作業完成時會發出事件物件的訊號。 否則，函式不會在作業完成或發生錯誤之前傳回。
傳回值
如果作業順利完成，表示磁片上的所有磁片區都可供使用， DeviceIoControl 會傳回非零值。
如果作業失敗或擱置中， DeviceIoControl 會 傳回零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
都不支援 |
| 最低支援的伺服器 |
Windows Server 2012 [僅限傳統型應用程式] |
| 標頭 |
|