Skip to content

Latest commit

 

History

History
109 lines (86 loc) · 3.22 KB

ni-winioctl-fsctl_query_sparing_info.md

File metadata and controls

109 lines (86 loc) · 3.22 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist f1_keywords dev_langs topic_type api_type api_location api_name
NI:winioctl.FSCTL_QUERY_SPARING_INFO
FSCTL_QUERY_SPARING_INFO
Retrieves the defect management properties of the volume. Used for UDF file systems.
FSCTL_QUERY_SPARING_INFO
FSCTL_QUERY_SPARING_INFO control
FSCTL_QUERY_SPARING_INFO control code [Files]
fs.fsctl_query_sparing_info
winioctl/FSCTL_QUERY_SPARING_INFO
fs\fsctl_query_sparing_info.htm
fs
72122388-a42f-4c67-9539-20eb4c59dcf0
12/05/2018
FSCTL_QUERY_SPARING_INFO, FSCTL_QUERY_SPARING_INFO control, FSCTL_QUERY_SPARING_INFO control code [Files], fs.fsctl_query_sparing_info, winioctl/FSCTL_QUERY_SPARING_INFO
winioctl.h
Windows.h
Windows
Windows Vista [desktop apps only]
Windows Server 2008 [desktop apps only]
Windows
FSCTL_QUERY_SPARING_INFO
winioctl/FSCTL_QUERY_SPARING_INFO
c++
APIRef
kbSyntax
HeaderDef
WinIoCtl.h
FSCTL_QUERY_SPARING_INFO

FSCTL_QUERY_SPARING_INFO IOCTL

-description

Retrieves the defect management properties of the volume. Used for UDF file systems.

To perform this operation, call the DeviceIoControl function with the following parameters.

BOOL DeviceIoControl(
  (HANDLE) hDevice,             // handle to device
  FSCTL_QUERY_SPARING_INFO,     // dwIoControlCode
  NULL,                         // input buffer
  0,                            // size of input buffer
  (LPVOID) lpOutBuffer,         // output buffer
  (DWORD) nOutBufferSize,       // size of output buffer
  (LPDWORD) lpBytesReturned,    // number of bytes returned
  (LPOVERLAPPED) lpOverlapped   // OVERLAPPED structure
);

-ioctlparameters

-input-buffer

-input-buffer-length

-output-buffer

-output-buffer-length

-in-out-buffer

-inout-buffer-length

-status-block

Irp->IoStatus.Status is set to STATUS_SUCCESS if the request is successful.

Otherwise, Status to the appropriate error condition as a NTSTATUS code.

For more information, see NTSTATUS Values.

-remarks

One scenario this control code can be used for is by an application that reports volume statistics to the user and warns if the volume is running out of free storage space.

In Windows 8 and Windows Server 2012, this code is supported by the following technologies.

Technology Supported
Server Message Block (SMB) 3.0 protocol Yes
SMB 3.0 Transparent Failover (TFO) Yes
SMB 3.0 with Scale-out File Shares (SO) Yes
Cluster Shared Volume File System (CsvFS) No
Resilient File System (ReFS) Yes

-see-also