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
이 구조체의 크기(바이트)입니다. GET_BAND_METADATA_PARAMETERS(sizeof)로 설정합니다.
BandId
정보를 반환할 단일 대역의 식별자입니다. BandSizeBandId를 사용하여 단일 밴드를 선택하면 0이어야 합니다. bandId 대신 BandStart 및 BandSize 사용하여 밴드를 선택하려면 BandId = (ULONG) –1을 설정합니다.
BandStart
대역 검색을 시작할 스토리지 디바이스의 시작 바이트 위치입니다. BandStart이후에 밴드를 일치시키려고 시도합니다.
MetadataOffset
데이터를 검색할 대역 메타데이터 속성의 시작 부분부터의 오프셋입니다.
MetadataSize
검색할 메타데이터 바이트의 길이입니다.
발언
밴드 선택에 대한 BandID 우선 순위가 지정됩니다. BandID 0보다 크고 BandIDBAND_MANAGEMENT_CAPABILITIESMaxBandCount 멤버보다 작으면 BandID 밴드 일치의 유일한 선택 조건으로 사용됩니다. BandID == –1이면 BandStart 밴드를 선택하는 일치 조건으로 사용됩니다. 선택 조건과 일치하는 밴드가 없으면 IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATAIoStatus 블록에 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 포함) |