IOCTL_DISK_SET_CLUSTER_INFO código de control
Establece la información del clúster en un disco.
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_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
Parámetros
-
hDevice
-
Identificador del disco.
Para recuperar un identificador de dispositivo, llame a la función CreateFile .
-
dwIoControlCode
-
Código de control de la operación.
Use IOCTL_DISK_SET_CLUSTER_INFO para esta operación.
-
lpInBuffer
-
Puntero a una estructura de datos DISK_CLUSTER_INFO que contiene información de clúster para el disco.
-
nInBufferSize
-
Tamaño del búfer de entrada, en bytes.
-
lpOutBuffer
-
No se usa con esta operación. Establezca en NULL.
-
nOutBufferSize
-
Tamaño del búfer de salida, en bytes. Establezca en 0 (cero).
-
lpBytesReturned
-
No se usa con esta operación. Establezca en NULL.
-
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 contiene un identificador para un objeto de evento. De lo contrario, se produce un error en la función de maneras impredecibles.
En el caso de 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, lo que indica que todos los volúmenes del disco están listos para su uso, DeviceIoControl devuelve un valor distinto de cero.
Si se produce un error en la operación o está pendiente, DeviceIoControl devuelve cero. 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 |
|