Auf Englisch lesen

Freigeben über


IOCTL_DISK_ARE_VOLUMES_READY-Steuerelementcode

Wartet, bis alle Volumes auf dem angegebenen Datenträger einsatzbereit sind.

Um diesen Vorgang auszuführen, rufen Sie die DeviceIoControl-Funktion mit den folgenden Parametern auf.

BOOL 
WINAPI 
DeviceIoControl( (HANDLE)       hDevice,         // handle to device 
                 IOCTL_DISK_ARE_VOLUMES_READY,   // dwIoControlCode
                 (LPVOID)       NULL,            // lpInBuffer 
                 (DWORD)        0,               // nInBufferSize 
                 (LPVOID)       NULL,            // lpOutBuffer 
                 (DWORD)        0,               // nOutBufferSize
                 (LPDWORD)      lpBytesReturned, // number of bytes returned
                 (LPOVERLAPPED) lpOverlapped );  // OVERLAPPED structure

Parameter

hDevice

Ein Handle für den Datenträger.

Um ein Gerätehandle abzurufen, rufen Sie die CreateFile-Funktion auf.

dwIoControlCode

Der Steuerelementcode für den Vorgang.

Verwenden Sie für diesen Vorgang IOCTL_DISK_ARE_VOLUMES_READY .

lpInBuffer

Wird nicht mit diesem Vorgang verwendet. Auf NULL festgelegt.

nInBufferSize

Die Größe des Eingabepuffers in Bytes. Auf 0 (null) festgelegt.

lpOutBuffer

Wird nicht mit diesem Vorgang verwendet. Auf NULL festgelegt.

nOutBufferSize

Wird nicht mit diesem Vorgang verwendet. Auf 0 (null) festgelegt.

lpBytesReturned

Wird nicht mit diesem Vorgang verwendet. Auf NULL festgelegt.

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 überlappender (asynchroner) Vorgang ausgeführt. In diesem Fall muss lpOverlapped auf eine gültige OVERLAPPED-Struktur verweisen, 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 wird die Funktion erst zurückgegeben, 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 null zurück.

Wenn der Vorgang fehlschlägt oder aussteht, gibt DeviceIoControl null zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2012 [nur Desktop-Apps]
Header
Ntdddisk.h

Siehe auch

Deviceiocontrol

Steuerungscodes für die Datenträgerverwaltung