Condividi tramite


codice di controllo IOCTL_DISK_SET_CLUSTER_INFO

Imposta le informazioni del cluster su un disco.

Per eseguire questa operazione, chiamare la funzione DeviceIoControl con i parametri seguenti.

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

Parametri

hDevice

Handle per il disco.

Per recuperare un handle di dispositivo, chiamare la funzione CreateFile .

dwIoControlCode

Codice di controllo per l'operazione.

Usare IOCTL_DISK_SET_CLUSTER_INFO per questa operazione.

lpInBuffer

Puntatore a una struttura di dati DISK_CLUSTER_INFO che contiene informazioni sul cluster per il disco.

nInBufferSize

Dimensioni del buffer di input, in byte.

lpOutBuffer

Non usato con questa operazione. Impostare su NULL.

nOutBufferSize

Dimensioni in byte del buffer di output. Impostare su 0 (zero).

lpBytesReturned

Non usato con questa operazione. Impostare su NULL.

lpOverlapped

Puntatore a una struttura OVERLAPPED .

Se hDevice è stato aperto senza specificare FILE_FLAG_OVERLAPPED, lpOverlapped viene ignorato.

Se hDevice è stato aperto con il flag FILE_FLAG_OVERLAPPED , l'operazione viene eseguita come operazione sovrapposta (asincrona). In questo caso , lpOverlapped deve puntare a una struttura OVERLAPPED valida che contiene un handle a un oggetto evento. In caso contrario, la funzione ha esito negativo in modi imprevedibili.

Per le operazioni sovrapposte, DeviceIoControl restituisce immediatamente e l'oggetto evento viene segnalato al termine dell'operazione. In caso contrario, la funzione non restituisce finché l'operazione non è stata completata o si verifica un errore.

Valore restituito

Se l'operazione viene completata correttamente, a indicare che tutti i volumi sul disco sono pronti per l'uso, DeviceIoControl restituisce un valore diverso da zero.

Se l'operazione ha esito negativo o è in sospeso, DeviceIoControl restituisce zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Requisiti

Requisito Valore
Client minimo supportato
Nessuno supportato
Server minimo supportato
Windows Server 2012 [solo app desktop]
Intestazione
Ntdddisk.h

Vedi anche

Deviceiocontrol

Codici di controllo di gestione dei dischi

DISK_CLUSTER_INFO

IOCTL_DISK_GET_CLUSTER_INFO