共用方式為

IOCTL_DISK_ARE_VOLUMES_READY控制項程式碼

  • 發行項

等候指定磁片上的所有磁片區都可供使用。

若要執行這項作業，請使用下列參數呼叫 DeviceIoControl 函 式。

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

參數

hDevice

磁片的控制碼。

若要擷取裝置控制碼，請呼叫 CreateFile 函式。

dwIoControlCode

作業的控制程式代碼。

使用此作業 IOCTL_DISK_ARE_VOLUMES_READY 。

lpInBuffer

未與這項作業搭配使用。 設定為 Null。

nInBufferSize

輸入緩衝區的大小，以位元組為單位。 設定為 0 (零) 。

lpOutBuffer

未與這項作業搭配使用。 設定為 Null。

nOutBufferSize

未與這項作業搭配使用。 設定為 0 (零) 。

lpBytesReturned

未與這項作業搭配使用。 設定為 Null。

lpOverlapped

重迭結構的指標。

如果 開啟 hDevice 而不指定 FILE_FLAG_OVERLAPPED，則會忽略 lpOverlapped 。

如果 hDevice 是以 FILE_FLAG_OVERLAPPED 旗標開啟，則會以重迭的 (非同步) 作業來執行。 在此情況下， lpOverlapped 必須指向包含事件物件控制碼的有效 OVERLAPPED 結構。 否則，函式會以無法預期的方式失敗。

針對重迭的作業， DeviceIoControl 會立即傳回，而且當作業完成時會發出事件物件的訊號。 否則，函式不會在作業完成或發生錯誤之前傳回。

傳回值

如果作業順利完成，表示磁片上的所有磁片區都可供使用， DeviceIoControl 會傳回非零值。

如果作業失敗或擱置中， DeviceIoControl 會 傳回零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

規格需求

需求 值
最低支援的用戶端
 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2012 [僅限傳統型應用程式]
標頭
Ntdddisk.h

另請參閱

DeviceIoControl

磁片管理控制代碼