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 を呼び出します。

必要条件

関連項目

DeviceIoControl

ディスク管理の制御コード

DISK_CLUSTER_INFO

IOCTL_DISK_GET_CLUSTER_INFO