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 포함) |