IOCTL_CDROM_GET_CONFIGURATION IOCTL (ntddcdrm.h)
Solicita información de características y perfiles de un dispositivo CD-ROM.
Los dispositivos multimedia tienen características diferentes en función del tipo de medio que se encuentra en el dispositivo. Para proporcionar controladores con un medio de consultar dispositivos multimedia sobre estas características variables, la especificación SCSI Multimedia - 3 (MMC-3) define un comando denominado "GET CONFIGURATION". Este comando permite a los controladores consultar un dispositivo para obtener información permanente sobre el dispositivo e información que varía cada vez que cambia el medio. En los sistemas operativos Microsoft Windows 2000 y versiones posteriores, los controladores pueden enviar esta consulta a un dispositivo mediante la solicitud IOCTL_CDROM_GET_CONFIGURATION.
La solicitud IOCTL_CDROM_GET_CONFIGURATION devuelve una lista de descriptores que describen las funcionalidades del dispositivo para el medio actual. Estos descriptores se dividen en dos grupos denominados "descriptores de características" y "descriptores de lista de perfiles". Una característica especifica las funcionalidades de un dispositivo y su medio asociado. Un perfil es una colección de características. Si el dispositivo admite un perfil, admite todas las características del perfil.
Consulte la especificación MMC-3 para obtener más información sobre las características y los perfiles.
Código principal
Búfer de entrada
Búfer de entrada.
Longitud del búfer de entrada
Parameters.DeviceIoControl.InputBufferLength en la estructura IO_STACK_LOCATION indica el tamaño, en bytes, del búfer de entrada, que debe ser = sizeof(GET_CONFIGURATION_IOCTL_INPUT).
Búfer de salida
El controlador devuelve la característica y los datos de perfil en el búfer en Irp-AssociatedIrp.SystemBuffer>. Los datos comienzan con un encabezado de tipo GET_CONFIGURATION_HEADER. Los datos de características se notifican en el espacio inmediatamente después de este encabezado. Su tamaño y formato dependen de las características que se notifican.
Longitud del búfer de salida
Parameters.DeviceIoControl.OutputBufferLength en la ubicación de la pila de E/S indica el tamaño, en bytes, del búfer, que debe ser >= sizeof(GET_CONFIGURATION_HEADER).
Bloque de estado
El campo Información se establece en el número de bytes que se devuelven. El campo Estado se establece en STATUS_SUCCESS si la solicitud se realiza correctamente. Si Parameters.DeviceIoControl.InputBufferLength no tiene el valor correcto, la solicitud produce un error de STATUS_INFO_LENGTH_MISMATCH. Si Parameters.DeviceIoControl.OutputBufferLength no es lo suficientemente grande, la solicitud produce un error de STATUS_BUFFER_TOO_SMALL. Si el valor del búfer de salida es demasiado grande, la solicitud produce un error en un mensaje de STATUS_INVALID_BUFFER_SIZE.
Requisitos
| Requisito | Valor |
|---|---|
| Header | ntddcdrm.h (incluya Ntddcdrm.h) |
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de