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
-
OVERLAPPED 構造体へのポインター。
FILE_FLAG_OVERLAPPEDを指定せずに hDevice を開いた場合、lpOverlapped は無視されます。
hDevice が FILE_FLAG_OVERLAPPED フラグで開かれた場合、操作は重複 (非同期) 操作として実行されます。 この場合、 lpOverlapped は、イベント オブジェクトへのハンドルを含む有効な OVERLAPPED 構造体を指す必要があります。 それ以外の場合、関数は予期しない方法で失敗します。
重複する操作の場合、 DeviceIoControl は直ちにを返し、操作が完了するとイベント オブジェクトが通知されます。 それ以外の場合、関数は操作が完了するかエラーが発生するまで戻りません。
戻り値
操作が正常に完了し、ディスク上のすべてのボリュームが使用できる状態であることを示す場合、 DeviceIoControl は 0 以外の値を返します。
操作が失敗した場合、または保留中の場合、 DeviceIoControl は 0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
サポートなし |
| サポートされている最小のサーバー |
Windows Server 2012 [デスクトップ アプリのみ] |
| Header |
|