IOCTL _ VOLUME _ IS _ CSV-Steuerungscode
Bestimmt, ob ein Volume ein CSV-Volume ist.
Um diesen Vorgang durchzuführen, rufen Sie die Funktion DeviceIoControl mit den folgenden Parametern auf.
BOOL
WINAPI
DeviceIoControl( (HANDLE) hDevice, // handle to device
IOCTL_VOLUME_IS_CSV, // dwIoControlCode
NULL, // input buffer
0, // size of input buffer
(LPVOID) lpOutBuffer, // lpOutBuffer
(DWORD) nOutBufferSize, // nOutBufferSize
(LPDWORD) lpBytesReturned, // number of bytes returned
(LPOVERLAPPED) lpOverlapped ); // OVERLAPPED structure
Parameter
-
hDevice
-
Ein Handle für das Volume. Um ein Volumehand handle abzurufen, rufen Sie die CreateFile-Funktion auf. Nur Administratoren können Volumehandles öffnen.
-
dwIoControlCode
-
Der Steuerungscode für den Vorgang. Verwenden Sie IOCTL _ VOLUME IS CSV _ _ für diesen Vorgang.
-
lpInBuffer
-
Wird mit diesem Vorgang nicht verwendet. auf NULL festgelegt.
-
nInBufferSize
-
Wird mit diesem Vorgang nicht verwendet. auf null (0) festgelegt.
-
lpOutBuffer
-
Ein Zeiger auf TRUE, wenn das Volume ein CSV-Volume ist. Andernfalls schlägt der Funktionsaufruf fehl.
-
nOutBufferSize
-
Die Größe des Ausgabepuffers in Bytes.
-
lpBytesReturned
-
Ein Zeiger auf eine Variable, die die Größe der im Ausgabepuffer gespeicherten Daten in Bytes empfängt.
Wenn lpOverlapped NULL ist, kann lpBytesReturned nicht NULL sein. Auch wenn ein Vorgang keine Ausgabedaten zurückgibt und lpOutBuffer NULL ist, verwendet DeviceIoControl lpBytesReturned. Nach einem solchen Vorgang ist der Wert von lpBytesReturned bedeutungslos.
Wenn lpOverlapped nicht NULL ist, kann lpBytesReturned NULL sein. Wenn dieser Parameter nicht NULL ist und der Vorgang Daten zurückgibt, ist lpBytesReturned bedeutungslos, bis der überlappende Vorgang abgeschlossen ist. Rufen Sie getOverlappedResultauf, um die Anzahl der zurückgegebenen Bytes abzurufen. Wenn hDevice einem E/A-Abschlussport zugeordnet ist, können Sie die Anzahl der zurückgegebenen Bytes abrufen, indem Sie GetQueuedCompletionStatus aufrufen.
-
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, 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 |
|