Код элемента управления IOCTL_VOLUME_IS_CSV

Статья
06/13/2023

Определяет, является ли том томом CSV.

Для выполнения этой операции вызовите функцию DeviceIoControl со следующими параметрами.

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

Параметры

hDevice

Дескриптор тома. Чтобы получить дескриптор тома, вызовите функцию CreateFile . Только администраторы могут открывать дескрипторы томов.

dwIoControlCode

Код элемента управления для операции. Используйте IOCTL_VOLUME_IS_CSV для этой операции.

lpInBuffer

Не используется с этой операцией; для параметра задано значение NULL.

nInBufferSize

Не используется с этой операцией; значение равно нулю (0).

lpOutBuffer

Указатель на TRUE , если том является томом CSV; В противном случае вызов функции завершается ошибкой.

nOutBufferSize

Размер выходного буфера в байтах.

lpBytesReturned

Указатель на переменную, которая получает размер данных, хранящихся в выходном буфере, в байтах.

Если lpOverlapped имеет значение NULL, lpBytesReturned не может иметь значение NULL. Даже если операция не возвращает выходные данные и lpOutBuffer имеет значение NULL, DeviceIoControl использует lpBytesReturned. После такой операции значение lpBytesReturned не имеет смысла.

Если значение lpOverlapped не равно NULL, lpBytesReturned может иметь значение NULL. Если этот параметр не равен NULL и операция возвращает данные, функция lpBytesReturned не имеет смысла до завершения перекрывающейся операции. Чтобы получить количество возвращенных байтов, вызовите Метод GetOverlappedResult. Если hDevice связан с портом завершения ввода-вывода, можно получить количество возвращаемых байтов, вызвав Метод GetQueuedCompletionStatus.

lpOverlapped

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

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

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

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

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

Если операция завершается успешно, DeviceIoControl возвращает ненулевое значение.

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

Требования

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

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

CreateFile
DeviceIoControl
Управляющие коды для управления томами

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