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 | LBA 범위는 FileTypeID 멤버에 지정된 파일 형식에서 더 이상 사용되지 않습니다. |
NumFileTypeIDs
FileTypeID 멤버의 항목 수입니다.
FileTypeID[ANYSIZE_ARRAY]
알림 작업의 파일 형식을 지정하는 하나 이상의 GUID 값입니다. 다음 표에서는 FileTypeID GUID 값에 대해 설명합니다.
| GUID 값 | 묘사 |
|---|---|
| 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 포함) |