IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES IOCTL (ntddstor.h)

Artículo
03/05/2024

Esta IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES solicitud se usa para enviar una solicitud de administración de conjuntos de datos a un dispositivo de almacenamiento.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

El búfer de Irp-AssociatedIrp.SystemBuffer> contiene una estructura de DEVICE_DSM_INPUT. Según el miembro Action de esta estructura, el búfer de entrada puede incluir además un bloque de parámetros y un bloque de intervalos de conjuntos de datos. Consulte DEVICE_DSM_ACTION Descripciones para obtener descripciones de todas las acciones posibles.

Longitud del búfer de entrada

Parameters.DeviceIoControl.InputBufferLength en la ubicación de pila de E/S del IRP indica el tamaño, en bytes, del búfer, que debe ser al menos sizeof(DEVICE_DSM_INPUT).

Búfer de salida

Según el valor establecido en el miembro Action de DEVICE_DSM_INPUT, la solicitud puede devolver datos en el búfer en Irp-AssociatedIrp.SystemBuffer>. El búfer del sistema contendrá datos DEVICE_DSM_OUTPUT válidos si la operación DSM devuelve la salida y Parameters.DeviceIoControl.OutputBufferLength> 0. Dependiendo de Acción, el búfer de salida podría incluir además un bloque de salida.

Longitud del búfer de salida

Longitud en bytes del búfer de salida, si existe. Si se devuelve la salida, el búfer de salida debe ser al menos sizeof(DEVICE_DSM_OUTPUT).

Bloque de estado

El campo Estado se puede establecer en STATUS_SUCCESS, o posiblemente en STATUS_INVALID_DEVICE_REQUEST, STATUS_BUFFER_TOO_SMALL, STATUS_BUFFER_OVERFLOW o algún otro estado de error.

Comentarios

Debido a los requisitos del grupo de memoria de la pila del controlador de almacenamiento, la finalización del IRP que contiene este IOCTL debe estar en irQL < DISPATCH_LEVEL.

Consulte Información general sobre la administración de conjuntos de datos para obtener más información.