Поделиться через


код элемента управления 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 .

Если hDevice был открыт без указания FILE_FLAG_OVERLAPPED, lpOverlapped игнорируется.

Если hDevice был открыт с флагом FILE_FLAG_OVERLAPPED , операция выполняется как перекрываемая (асинхронная) операция. В этом случае lpOverlapped должен указывать на допустимую структуру OVERLAPPED , содержащую дескриптор объекта события. В противном случае функция завершается сбоем непредсказуемым образом.

Для перекрывающихся операций DeviceIoControl возвращает немедленно, а объект события получает сигнал о завершении операции. В противном случае функция не возвращается, пока операция не будет завершена или не возникнет ошибка.

Возвращаемое значение

Если операция завершается успешно, указывая, что все тома на диске готовы к использованию, DeviceIoControl возвращает ненулевое значение.

Если операция завершается сбоем или находится в состоянии ожидания, DeviceIoControl возвращает ноль. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Требования

Требование Значение
Минимальная версия клиента
Ни одна версия не поддерживается
Минимальная версия сервера
Windows Server 2012 [только классические приложения]
Заголовок
Ntdddisk.h

См. также раздел

DeviceIoControl

Коды управления дисками

DISK_CLUSTER_INFO

IOCTL_DISK_GET_CLUSTER_INFO