IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES IOCTL (ntddstor.h)

Artículo
02/07/2025

Esta IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES solicitud se usa para enviar una solicitud de administración del conjunto 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 Acción miembro 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 la pila de E/S del IRP indica el tamaño, en bytes, del búfer, que debe ser al menos tamaño de(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 válidos DEVICE_DSM_OUTPUT si la operación DSM devuelve la salida y Parameters.DeviceIoControl.OutputBufferLength> 0. Dependiendo de Acción, el búfer de salida también puede incluir 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 tamaño de(DEVICE_DSM_OUTPUT).

Bloque de estado

El campo Estado de 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.

Observaciones

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.