DEVICE_DSM_NOTIFICATION_PARAMETERS 구조체(ntddstor.h)

  • 아티클

DEVICE_DSM_NOTIFICATION_PARAMETERS 구조는 디바이스의 데이터 집합 특성과 관련된 알림 작업에 대한 매개 변수를 지정합니다.

구문

typedef struct _DEVICE_DSM_NOTIFICATION_PARAMETERS {
  ULONG Size;
  ULONG Flags;
  ULONG NumFileTypeIDs;
  GUID  FileTypeID[ANYSIZE_ARRAY];
} DEVICE_DSM_NOTIFICATION_PARAMETERS, *PDEVICE_DSM_NOTIFICATION_PARAMETERS;

멤버

Size

이 구조체의 총 크기(바이트)입니다. 이 멤버의 값에는 FileTypeID 멤버의 총 크기(바이트)가 포함되어야 합니다.

Flags

알림 작업의 특성을 지정하는 플래그입니다. Flags 멤버는 다음 값 중 하나로 설정해야 합니다.

플래그 의미
DEVICE_DSM_NOTIFY_FLAG_BEGIN LBA(논리 블록 주소) 범위는 현재 FileTypeID 멤버에 지정된 파일 형식에서 사용되고 있습니다. LBA 범위는 IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES 요청의 페이로드 내의 데이터 집합 범위에 의해 지정됩니다.
DEVICE_DSM_NOTIFY_FLAG_END FileTypeID 멤버에 지정된 파일 형식에서 LBA 범위를 더 이상 사용하지 않습니다.

NumFileTypeIDs

FileTypeID 멤버의 항목 수입니다.

FileTypeID[ANYSIZE_ARRAY]

알림 작업의 파일 형식을 지정하는 하나 이상의 GUID 값입니다. 다음 표에서는 FileTypeID GUID 값에 대해 설명합니다.

GUID 값 Description
FILE_TYPE_NOTIFICATION_GUID_PAGE_FILE 페이지 파일에 대한 알림 작업을 지정합니다.
FILE_TYPE_NOTIFICATION_GUID_HIBERNATION_FILE 시스템 최대 절전 모드 파일에 대한 알림 작업을 지정합니다.
FILE_TYPE_NOTIFICATION_GUID_CRASHDUMP_FILE 시스템 크래시 덤프 파일에 대한 알림 작업을 지정합니다.

설명

알림은 IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES 요청의 페이로드 내의 매개 변수 블록에 지정됩니다. 페이로드 레이아웃에 대한 일반적인 설명은 데이터 세트 관리 개요 를 참조하세요.

Windows 7부터 NTFS 파일 시스템은 지정된 파일 집합에 대해 LBA(논리 블록 주소 지정) 데이터 집합 범위가 변경될 때 스토리지 스택에 알릴 수 있습니다. 파일 시스템은 스토리지 스택에 DEVICE_DSM_INPUT 구조가 포함된 시스템 버퍼를 사용하여 IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES 요청을 전송하여 이 알림을 실행합니다. 알림 작업의 경우 파일 시스템은 다음과 같이 DEVICE_DSM_INPUT 구조체의 멤버를 설정합니다.

  • Action 멤버가 DeviceDsmAction_Notification 설정됩니다.
  • ParameterBlockOffset 및 ParameterBlockLength 멤버는 알림 작업에 대한 매개 변수 블록의 위치와 크기를 지정합니다. 매개 변수 블록의 형식은 DEVICE_DSM_NOTIFICATION_PARAMETERS 구조체로 지정됩니다.
  • Flags 멤버가 0으로 설정된 경우 DataSetRangesOffset 및 DataSetRangesLength 멤버는 IOCTL 페이로드 내에서 데이터 집합 범위 블록을 지정합니다.
  • Flags 멤버가 DEVICE_DSM_FLAG_ENTIRE_DATA_SET_RANGE 설정되면 DataSetRangesOffset 및 DataSetRangesLength 멤버가 0으로 설정되고 알림 작업에는 지정된 파일에 대한 전체 데이터 집합 범위가 포함됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7
지원되는 최소 서버 Windows Server 2008 R2
머리글 ntddstor.h(Ntddstor.h 포함)

추가 정보

데이터 집합 관리 개요

DEVICE_DSM_ACTION 설명

DEVICE_DSM_INPUT

IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES