GET_BAND_METADATA_PARAMETERS 구조체(ehstorbandmgmt.h)
구성된 대역에 대한 메타데이터는 GET_BAND_METADATA_PARAMETERS 구조의 매개 변수에 따라 검색됩니다. 이 구조는 IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA 요청에 대한 입력입니다.
구문
typedef struct _GET_BAND_METADATA_PARAMETERS {
ULONG StructSize;
ULONG BandId;
LARGE_INTEGER BandStart;
ULONG MetadataOffset;
ULONG MetadataSize;
} GET_BAND_METADATA_PARAMETERS, *PGET_BAND_METADATA_PARAMETERS;
멤버
StructSize
이 구조체의 크기(바이트)입니다. sizeof(GET_BAND_METADATA_PARAMETERS)로 설정합니다.
BandId
정보를 반환할 단일 대역의 식별자입니다. BandId를 사용하여 단일 밴드를 선택한 경우 BandSize는 0이어야 합니다.BandId 대신 BandStart 및 BandSize를 사용하여 밴드를 선택하려면 BandId = (ULONG) –1을 설정합니다.
BandStart
대역 검색을 시작할 스토리지 디바이스의 시작 바이트 위치입니다. BandStart 또는 그 이후에 밴드를 일치시키려고 시도합니다.
MetadataOffset
데이터를 검색할 대역 메타데이터 속성의 시작부터의 오프셋입니다.
MetadataSize
검색할 메타데이터 바이트의 길이입니다.
설명
밴드 선택 시 BandID 에 우선 순위가 지정됩니다. BandID가 0보다 크고 BandID가 BAND_MANAGEMENT_CAPABILITIESMaxBandCount 멤버보다 작은 경우 BandID는 밴드 일치의 유일한 선택 조건으로 사용됩니다. BandID == –1이면 BandStart가 대역을 선택하는 일치 조건으로 사용됩니다. 선택 조건과 일치하는 밴드가 없으면 IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA 대한 IoStatus 블록에 STATUS_INVALID_PARAMETER 반환됩니다.
BandID와 BandStart가 모두 –1로 설정된 경우 IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA 전역 밴드에 대한 메타데이터를 반환합니다.
IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA 성공한 경우 Parameters.DeviceIoControl.InputBufferLength는 MetadataSize의 값과 같습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 |
| 머리글 | ehstorbandmgmt.h(EhStorBandMgmt.h 포함) |