Freigeben über

FSCTL_SET_REFS_SMR_VOLUME_GC_PARAMETERS-Steuerungscode

  • Artikel

Der FSCTL_SET_REFS_SMR_VOLUME_GC_PARAMETERS Steuercode steuert die Garbage Collection auf einem SMR-Volume (Shingled Magnetic Recording).

BOOL
   DeviceIoControl( (HANDLE)       hDevice,         // handle to volume
                    FSCTL_SET_REFS_SMR_VOLUME_GC_PARAMETERS, // dwIoControlCode
                    (LPDWORD)      lpInBuffer,      // input buffer
                    (DWORD)        nInBufferSize,   // size of input buffer
                     NULL,     // output buffer
                     0,  // size of output buffer
                    (LPDWORD)      lpBytesReturned, // number of bytes returned
                    (LPOVERLAPPED) lpOverlapped );  // OVERLAPPED structure

Parameter

  • hDevice [in]: Ein Handle für das Gerät. Rufen Sie die CreateFile-Funktion auf, um ein Gerätehandle zu erhalten.

  • dwIoControlCode [in]: Der Steuerelementcode für den Vorgang. Verwenden Sie für diesen Vorgang FSCTL_SET_REFS_SMR_VOLUME_GC_PARAMETERS .

  • lpInBuffer [in]: Ein Zeiger auf eine aufruferseitig zugeordnete REFS_SMR_VOLUME_GC_PARAMETERS-Struktur .

  • nInBufferSize [in]: Die Größe des Eingabepuffers in Bytes.

  • lpOutBuffer [out]: Bei diesem Vorgang nicht verwendet; auf NULL festgelegt.

  • nOutBufferSize [in]: Nicht für diesen Vorgang verwendet; auf 0 (null) festgelegt.

  • lpBytesReturned [out]: Bei diesem Vorgang nicht verwendet; auf NULL festgelegt.

  • lpOverlapped [in]: 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 Struktur OVERLAPPED 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 dem 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 wird, 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

Anforderungstyp Anforderung
Unterstützte Mindestversion (Client) Windows 10, Version 1709
Header WinIoctl.h

Siehe auch

DeviceIoControl