IOCTL_DISK_COPY_EXTERNAL_START (Compact 2013)

3/26/2014

This I/O control message is called by the file system to inform the block driver which sectors correspond to a file. This allows data to be read from or written to a file directly on an external device. Send this message with DeviceIoControl.

Syntax

BOOL DeviceIoControl(
    HANDLE hDevice,           // handle to device
    DWORD dwIoControlCode,    // use IOCTL_DISK_COPY_EXTERNAL_START
    LPVOID lpInBuffer,        // pointer to input buffer
    DWORD nInBufferSize,      // input buffer size
    LPVOID lpOutBuffer,       // pointer to output buffer
    DWORD nOutBufferSize,     // output buffer size
    LPDWORD lpBytesReturned,  // number of bytes returned
    OVERLAPPED lpOverlapped   // pointer to OVERLAPPED structure
);

Parameters

• hDevice
  The handle to the device.

• dwIoControlCode
  [in] Control code for the operation. Use IOCTL_DISK_COPY_EXTERNAL_START for this operation.

• lpInBuffer
  [in] Pointer to a DISK_COPY_EXTERNAL structure.

• nInBufferSize
  [in] Size of the input buffer.

• lpOutBuffer
  [out] Not used; set to NULL.

• nOutBufferSize
  [out] Not used; set to zero.

• lpBytesReturned
  [out] Not used; set to NULL.

• lpOverlapped
  Not used.

Return Values

Returns nonzero value if successful; otherwise, returns zero.

Requirements

See Also

Reference

Copy External I/O Controls
DISK_COPY_EXTERNAL