IOCTL_MOUNTDEV_QUERY_SUGGESTED_LINK_NAME IOCTL (mountdev.h)
IOCTL_MOUNTDEV_QUERY_SUGGESTED_LINK_NAME permite a los clientes del administrador de montaje, como controladores de dispositivo o volumen, sugerir una letra de unidad o un nombre de vínculo para sus volúmenes asociados.
La compatibilidad con este IOCTL por parte de los clientes del administrador de montaje es opcional.
Código principal
Búfer de entrada
Ninguno.
Longitud del búfer de entrada
Ninguno.
Búfer de salida
El controlador cliente debe colocar una estructura de longitud variable de tipo MOUNTDEV_SUGGESTED_LINK_NAME al principio del búfer en Irp-AssociatedIrp.SystemBuffer>. El controlador cliente debe insertar el nombre persistente sugerido en la dirección a la que apunta el miembro Name de esta estructura.
Longitud del búfer de salida
Parameters.DeviceIoControl.OutputBufferLength en la ubicación de pila de E/S del IRP indica el tamaño, en bytes, del búfer de salida, que debe ser mayor o igual que sizeof(MOUNTDEV_SUGGESTED_LINK_NAME).
Búfer de entrada y salida
N/D
Longitud del búfer de entrada y salida
N/D
Bloque de estado
Si la operación se realiza correctamente, el campo Información se establece en el número total de bytes devueltos y el campo Estado se establece en STATUS_SUCCESS.
Si OutputBufferLength es menor que sizeof(MOUNTDEV_SUGGESTED_LINK_NAME), el campo Estado se establece en STATUS_INVALID_PARAMETER.
Si OutputBufferLength es menor que la longitud total de los datos de salida, el campo Estado se establece en STATUS_BUFFER_OVERFLOW y el campo Información se establece en sizeof(MOUNTDEV_SUGGESTED_LINK_NAME).
Comentarios
Algunos clientes del administrador de montaje pueden realizar un seguimiento de sus letras de unidad en los reinicios del sistema sin la ayuda del administrador de montaje. Estos clientes pueden enviar un nombre de letra de unidad sugerido al administrador de montaje en respuesta a este IOCTL. El administrador de montaje usa el nombre sugerido si la base de datos del administrador de montaje aún no contiene un nombre de letra de unidad persistente para el volumen del cliente. De lo contrario, omite la sugerencia y usa el nombre de letra de unidad en su base de datos de nombres persistente.
Los nombres de letra de unidad deben incluir la ruta de acceso completa del vínculo simbólico en el espacio de nombres de objeto y deben tener la sintaxis tradicional de MS-DOS. Por ejemplo, la letra de unidad "D" debe representarse de esta manera: "\DosDevices\D:". ¿La alternativa ruta de vínculo simbólico de "?? \D:" no se puede usar, ni las abreviaturas del vínculo simbólico, como "D:".
El implementador de esta función no debe sincronizar subprocesos y no debe realizar llamadas de función de comunicación entre procesos (IPC) de bloqueo.
Para obtener más información, vea Admitir solicitudes del Administrador de montaje en un controlador de clase de almacenamiento.
Requisitos
| Requisito | Valor |
|---|---|
| Header | mountdev.h (include Mountdev.h) |