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

Указатель на структуру OVERLAPPED .

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

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

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

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

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

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

Требования

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

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

DeviceIoControl

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