IOCTL_DISK_GET_CLUSTER_INFO código de control

Recupera los atributos del dispositivo de disco especificado.

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_GET_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_GET_CLUSTER_INFO para esta operación.

lpInBuffer

No se usa con esta operación. Establezca en NULL.

nInBufferSize

Tamaño del búfer de entrada, en bytes. Establezca en 0 (cero).

lpOutBuffer

Puntero a un búfer que recibe una estructura de datos DISK_CLUSTER_INFO .

nOutBufferSize

Tamaño del búfer de salida, en bytes.

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 Valor
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_SET_CLUSTER_INFO