IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES IOCTL (ntddstor.h)

Artikel
02/29/2024

Diese IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES-Anforderung wird verwendet, um eine Datasetverwaltungsanforderung an ein Speichergerät zu senden.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Der Puffer bei Irp-AssociatedIrp.SystemBuffer> enthält eine DEVICE_DSM_INPUT-Struktur. Abhängig vom Action-Member dieser Struktur kann der Eingabepuffer zusätzlich einen Parameterblock und einen Block von Datasetbereichen enthalten. Beschreibungen aller möglichen Aktionen finden Sie unter DEVICE_DSM_ACTION Beschreibungen .

Eingabepufferlänge

Parameters.DeviceIoControl.InputBufferLength in der E/A-Stapelposition des IRP gibt die Größe des Puffers in Bytes an, die mindestens sizeof(DEVICE_DSM_INPUT) sein muss.

Ausgabepuffer

Abhängig vom Wert, der im Action-Member von DEVICE_DSM_INPUT festgelegt ist, gibt die Anforderung möglicherweise Daten im Puffer bei Irp-AssociatedIrp.SystemBuffer> zurück. Der Systempuffer enthält gültige DEVICE_DSM_OUTPUT Daten, wenn der DSM-Vorgang die Ausgabe und Parameters.DeviceIoControl.OutputBufferLength> 0 zurückgibt. Je nach Aktion kann der Ausgabepuffer zusätzlich einen Ausgabeblock enthalten.

Länge des Ausgabepuffers

Die Länge in Bytes des Ausgabepuffers, falls vorhanden. Wenn die Ausgabe zurückgegeben wird, muss der Ausgabepuffer mindestens sizeof(DEVICE_DSM_OUTPUT) aufweisen.

Statusblock

Das Feld Status kann auf STATUS_SUCCESS oder möglicherweise auf STATUS_INVALID_DEVICE_REQUEST, STATUS_BUFFER_TOO_SMALL, STATUS_BUFFER_OVERFLOW oder einen anderen Fehler status festgelegt werden.

Hinweise

Aufgrund der Speicherpoolanforderungen des Speichertreiberstapels muss der Abschluss des IRP, das diese IOCTL enthält, bei IRQL < DISPATCH_LEVEL erfolgen.

Weitere Informationen finden Sie unter Übersicht über die Datasetverwaltung .