DeviceDsmInitializeInput function (ntddstor.h)

Article
02/22/2024

The DeviceDsmInitializeInput function initializes the DEVICE_DSM_INPUT structure and parameter block, if any, of a data set management (DSM) operation.

Syntax

void DeviceDsmInitializeInput(
  PDEVICE_DSM_DEFINITION Definition,
  PDEVICE_DSM_INPUT      Input,
  ULONG                  InputLength,
  ULONG                  Flags,
  PVOID                  Parameters,
  ULONG                  ParameterBlockLength
);

Parameters

Definition

Pointer to a DEVICE_DSM_DEFINITION structure that defines the action.

Input

Pointer to a caller-allocated DEVICE_DSM_INPUT input structure.

InputLength

The length, in bytes, of the entire input buffer for the IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES request.

Flags

Flags for global control actions for the input. This value can be one of the DEVICE_DSM_FLAG_XXX values defined in ntddstor.h.

Parameters

Parameters for initializing the parameter block of the input structure. The format of the parameter block depends on the action defined by Definition. See DEVICE_DSM_ACTION Descriptions for a list of actions and their parameter block formats.

ParameterBlockLength

The length, in bytes, of the parameter block. If the action defined by Definition does not have parameters, ParameterBlockLength is set to zero.

Return value

None

Remarks

To add a data set range to the input operation, call DeviceDsmAddDataSetRange.

See Data Set Management Overview for information on how to set up and process a DSM action.

Requirements

Requirement	Value
Minimum supported client	Windows 10, version 1803
Target Platform	Universal
Header	ntddstor.h