ENUMERATE_BANDS_PARAMETERS 구조체(ehstorbandmgmt.h)

아티클
08/07/2023

ENUMERATE_BANDS_PARAMETERS 구조체는 IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS 요청에서 반환할 밴드 정보 항목을 선택하는 데 사용됩니다.

구문

typedef struct _ENUMERATE_BANDS_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  LARGE_INTEGER BandSize;
} ENUMERATE_BANDS_PARAMETERS, *PENUMERATE_BANDS_PARAMETERS;

멤버

StructSize

이 구조체의 크기(바이트)입니다. sizeof(ENUMERATE_BANDS_PARAMETERS)로 설정합니다.

Flags

밴드 열거형 플래그입니다. 이 값은 다음의 비트 OR 조합입니다.

값	의미
ENUMBANDS_ENUM_ALL_BANDS	모든 밴드가 반환됩니다. 이 플래그를 설정하면 BandId, BandStart 및 BandSize 멤버가 무시됩니다.
ENUMBANDS_REPORT_CRYPTO_ALGO	BAND_TABLE_ENTRYSecurityInfo 멤버에 미디어 암호화 알고리즘 정보를 포함합니다.

Reserved

예약되어 있습니다.

BandId

정보를 반환할 단일 대역의 식별자입니다. BandId를 사용하여 단일 밴드를 선택하는 경우 BandSize는 0이어야 합니다.BandId 대신 BandStart 및 BandSize를 사용하여 밴드를 선택하려면 BandId = (ULONG) –1을 설정합니다.

BandStart

대역 검색을 시작할 스토리지 디바이스의 시작 바이트 위치입니다. BandStart 또는 그 이후에 밴드를 일치시키려고 시도합니다.

BandSize

선택적 대역 크기 일치 값(바이트)입니다. BandSize == 0 및 BandId == –1인 경우 BandStart는 밴드를 선택하는 유일한 일치 값입니다. 그렇지 않으면 BandStart 및 일치하는 BandSize 에서 또는 그 이후의 밴드가 정확히 선택됩니다.

설명

플래그에서 ENUMBANDS_ENUM_ALL_BANDS 설정되지 않은 경우 단일 밴드와 일치하도록 선택하려고 시도합니다. BandID, BandStart 및 BandSize의 값을 기반으로 단일 밴드 일치가 수행됩니다. 밴드 선택 시 BandID 에 우선 순위가 지정됩니다. BAND_MANAGEMENT_CAPABILITIES BandID> 0 및 BandID<MaxBandCount 멤버가 0 보다 크고 BandID가 BAND_MANAGEMENT_CAPABILITIESMaxBandCount 멤버보다 작으면 BandID가 대역 일치의 유일한 선택 조건으로 사용됩니다. BandID == –1이면 BandStart 및 BandSize가 대역을 선택하는 일치 조건으로 사용됩니다.

BandStart 및 BandSize를 사용하여 밴드를 일치시키는 경우 BandSize의 정확한 크기를 갖는 BandStart 위치 또는 그 이후에 구성된 첫 번째 밴드가 반환됩니다. BandSize == 0인 경우 BandStart가 유효한 경우 BandStart 또는 그 이후에 구성된 첫 번째 밴드가 반환됩니다.

BandID == 0 또는 어떤 밴드도 구성되지 않고 Flags가 ENUMBANDS_ENUM_ALL_BANDS 설정되지 않은 경우 전체 디바이스에 대한 전역 밴드가 반환됩니다.

BandStart 및 BandSize 는 해당 값(바이트)이 기본 스토리지 디바이스의 섹터 크기의 정확한 배수가 아닌 한 유효하지 않습니다.