IOCTL_CDROM_READ_SG

This IOCTL reads scatter buffers from the CD-ROM and the information is stored in the CDROM_READ structure. The DeviceIoControl function calls this IOCTL.

Parameters

  • dwIoControlCode
    [in] Set to IOCTL_CDROM_READ_SG to read scatter buffers from the CD-ROM and store the information in the CDROM_READ structure.
  • lpInBuf
    [in] Set to the address of an allocated SGX_BUF structure.
  • nInBufSize
    [in] Set to the size of the SGX_BUF.
  • lpOutBuf
    [in, out] On input, set to the address of an allocated CDROM_READ structure. This is the memory needed for the structure and info storage. On output, a filled CDROM_READ structure.
  • nOutBufSize
    [in] Set to the size of the CDROM_READ.
  • lpBytesReturned
    [in, out] On input, address of a DWORD that receives the size in bytes of the data returned. On output, set to the number of bytes written to the supplied buffer.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To obtain extended error information, call GetLastError.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Cdioctl.h.

See Also

Block Drivers | CDROM_READ | DeviceIoControl | SGX_BUF

 Last updated on Tuesday, May 18, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.