IOCTL _ DISK GET CLUSTER _ _ _ INFO-Steuerungscode
Ruft die Attribute des angegebenen Datenträgergeräts ab.
Um diesen Vorgang durchzuführen, rufen Sie die Funktion DeviceIoControl mit den folgenden Parametern auf.
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
Parameter
-
hDevice
-
Ein Handle für den Datenträger.
Um ein Gerätehand handle abzurufen, rufen Sie die CreateFile-Funktion auf.
-
dwIoControlCode
-
Der Steuerungscode für den Vorgang.
Verwenden Sie IOCTL _ DISK GET CLUSTER _ _ _ INFO für diesen Vorgang.
-
lpInBuffer
-
Wird mit diesem Vorgang nicht verwendet. Legen Sie auf NULL fest.
-
nInBufferSize
-
Die Größe des Eingabepuffers in Bytes. Legen Sie auf 0 (null) fest.
-
lpOutBuffer
-
Ein Zeiger auf einen Puffer, der eine DISK _ CLUSTER _ INFO-Datenstruktur empfängt.
-
nOutBufferSize
-
Die Größe des Ausgabepuffers in Bytes.
-
lpBytesReturned
-
Wird mit diesem Vorgang nicht verwendet. Legen Sie auf NULL fest.
-
lpOverlapped
-
Ein Zeiger auf eine OVERLAPPED-Struktur.
Wenn hDevice geöffnet wurde, ohne FILE FLAG _ _ OVERLAPPED anzugeben, wird lpOverlapped ignoriert.
Wenn hDevice mit dem FLAG FILE FLAG _ _ OVERLAPPED geöffnet wurde, wird der Vorgang als überlappende (asynchrone) Operation ausgeführt. In diesem Fall muss lpOverlapped auf eine gültige OVERLAPPED-Struktur zeigen, die ein Handle für ein Ereignisobjekt enthält. Andernfalls schlägt die Funktion auf unvorhersehbare Weise fehl.
Bei überlappenden Vorgängen gibt DeviceIoControl sofort zurück, und das Ereignisobjekt wird signalisiert, wenn der Vorgang abgeschlossen wurde. Andernfalls gibt die Funktion erst dann zurück, wenn der Vorgang abgeschlossen wurde oder ein Fehler auftritt.
Rückgabewert
Wenn der Vorgang erfolgreich abgeschlossen wurde und angibt, dass alle Volumes auf dem Datenträger einsatzbereit sind, gibt DeviceIoControl einen Wert ungleich 0 (null) zurück.
Wenn der Vorgang fehlschlägt oder aussteht, gibt DeviceIoControl 0 (null) zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Nicht unterstützt |
| Unterstützte Mindestversion (Server) |
[Windows Server 2012 Nur Desktop-Apps] |
| Header |
|