2.3.31 FSCTL_GET_RETRIEVAL_POINTERS Request
The FSCTL_GET_RETRIEVAL_POINTERS request message requests that the server return a list of extents for the file or directory associated with the handle on which this FSCTL was invoked. The extents describe the mapping between virtual cluster numbers (VCNs) and logical cluster numbers (LCNs). This request is most commonly used by defragmentation utilities. This message contains a STARTING_VCN_INPUT_BUFFER data element.
The STARTING_VCN_INPUT_BUFFER data element is as follows.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
StartingVcn |
|||||||||||||||||||||||||||||||
|
... |
|||||||||||||||||||||||||||||||
StartingVcn (8 bytes): A 64-bit signed integer that contains the virtual cluster number (VCN) at which to begin retrieving extents in the file. This value MUST be greater than or equal to 0.