IOCTL_VOLUME_IS_CSV código de control
Determina si un volumen es un volumen CSV.
Para realizar esta operación, llame a la función DeviceIoControl con los parámetros siguientes.
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
Parámetros
-
hDevice
-
Identificador del volumen. Para recuperar un identificador de volumen, llame a la función CreateFile . Solo los administradores pueden abrir identificadores de volumen.
-
dwIoControlCode
-
Código de control para la operación. Use IOCTL_VOLUME_IS_CSV para esta operación.
-
lpInBuffer
-
No se utiliza con esta operación; se establece en NULL.
-
nInBufferSize
-
No se utiliza con esta operación; se establece en cero (0).
-
lpOutBuffer
-
Puntero a TRUE si el volumen es un volumen CSV; de lo contrario, se produce un error en la llamada a la función.
-
nOutBufferSize
-
Tamaño del búfer de salida, en bytes.
-
lpBytesReturned
-
Puntero a una variable que recibe el tamaño de los datos almacenados en el búfer de salida, en bytes.
Si lpOverlapped es NULL, lpBytesReturned no puede ser NULL. Incluso cuando una operación no devuelve datos de salida y lpOutBuffer es NULL, DeviceIoControl usa lpBytesReturned. Después de esta operación, el valor de lpBytesReturned no tiene sentido.
Si lpOverlapped no es NULL, lpBytesReturned puede ser NULL. Si este parámetro no es NULL y la operación devuelve datos, lpBytesReturned no tiene sentido hasta que se haya completado la operación superpuesta. Para recuperar el número de bytes devueltos, llame a GetOverlappedResult. Si hDevice está asociado a un puerto de finalización de E/S, puede recuperar el número de bytes devueltos llamando a GetQueuedCompletionStatus.
-
lpOverlapped
-
Puntero a una estructura SUPERPUESTA .
Si hDevice se abrió sin especificar FILE_FLAG_OVERLAPPED, se omite lpOverlapped .
Si hDevice se abrió con la marca FILE_FLAG_OVERLAPPED , la operación se realiza como una operación superpuesta (asincrónica). En este caso, lpOverlapped debe apuntar a una estructura SUPERPUESTA válida que contenga un identificador para un objeto de evento. De lo contrario, se produce un error en la función de maneras impredecibles.
Para las operaciones superpuestas, DeviceIoControl devuelve inmediatamente y el objeto de evento se señala cuando se ha completado la operación. De lo contrario, la función no devuelve hasta que se haya completado la operación o se produzca un error.
Valor devuelto
Si la operación se completa correctamente, DeviceIoControl devuelve un valor distinto de cero.
Si se produce un error en la operación o está pendiente, DeviceIoControl devuelve cero (0). Para obtener información de error extendida, llame a GetLastError.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
No se admite ninguno |
| Servidor mínimo compatible |
Windows Server 2012 [solo aplicaciones de escritorio] |
| Encabezado |
|