Hardware Dev Center

IOCTL_CDROM_GET_VOLUME control code

Determines the current volume for each of its device's audio ports. Obsolete, beginning with Windows Vista.

Input Parameters

Parameters.DeviceIoControl.OutputBufferLength in the I/O stack location indicates the size, in bytes, of the buffer, which must be greater than or equal to sizeof(VOLUME_CONTROL).

Output Parameters

The driver returns the VOLUME_CONTROL data in the buffer at Irp->AssociatedIrp.SystemBuffer.

I/O Status Block

The Information field is set to sizeof(VOLUME_CONTROL) when the Status field is set to STATUS_SUCCESS. Otherwise, the Information field is set to zero, and the Status field possibly can be set to STATUS_BUFFER_TOO_SMALL, STATUS_DEVICE_NOT_READY, STATUS_IO_DEVICE_ERROR, STATUS_VERIFY_REQUIRED, or STATUS_IO_TIMEOUT.

Remarks

Beginning with Windows Vista, CDROM class drivers do not use this IOCTL. Prior to Windows Vista, this IOCTL was used for audio playback on older CD-ROM drives that supported direct audio output in hardware.

Client applications should use the Media Control Interface (MCI) API rather than issuing this IOCTL.

Requirements

Version

Obsolete, beginning with Windows Vista.

Header

Ntddcdrm.h (include Ntddcdrm.h)

See also

VOLUME_CONTROL

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft