Compartir a través de


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
Ntdddisk.h

Consulte también

DeviceIoControl

Códigos de control de administración de discos

DISK_CLUSTER_INFO

IOCTL_DISK_GET_CLUSTER_INFO