IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA IOCTL(ehstorbandmgmt.h)
밴드와 연결된 메타데이터는 IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA 요청으로 검색됩니다. 대역에 대한 메타데이터는 키 관리자 애플리케이션의 데이터 영역 역할을 합니다.
주 코드
입력 버퍼
Irp-AssociatedIrp.SystemBuffer>의 입력 버퍼에는 GET_BAND_METADATA_PARAMETERS 구조체가 포함되어야 합니다.
입력 버퍼 길이
Parameters.DeviceIoControl.InputBufferLength 는 버퍼의 크기(바이트)를 나타내며 최소 sizeof (GET_BAND_METADATA_PARAMETERS)여야 합니다.
출력 버퍼
Irp-AssociatedIrp.SystemBuffer>의 출력 버퍼에는 GET_BAND_METADATA_PARAMETERS 지정된 대역 메타데이터의 바이트 배열이 포함되어 있습니다.
출력 버퍼 길이
GET_BAND_METADATA_PARAMETERS 구조체의 길이입니다.
상태 블록
정보 필드에는 출력 버퍼에 반환된 바이트 수가 포함됩니다. 상태 필드에 다음 값 중 하나를 반환할 수 있습니다.
| 상태 값 | Description |
|---|---|
| STATUS_SUCCESS | 메타데이터가 시스템 버퍼에 반환되었습니다. |
| STATUS_INVALID_DEVICE_REQUEST | 스토리지 디바이스는 대역 관리를 지원하지 않습니다. |
| STATUS_INVALID_BUFFER_SIZE | 출력 버퍼 크기가 잘못되었습니다. |
| STATUS_INVALID_PARAMETER | 입력 버퍼의 정보가 잘못되었습니다. |
| STATUS_NOT_FOUND | 제공된 선택 기준에 대한 밴드를 찾을 수 없습니다. |
| STATUS_IO_DEVICE_ERROR | 통신이 실패했습니다. 스토리지 디바이스가 보안 프로토콜과 호환되지 않을 수 있습니다. |
설명
이 IOCTL에 대한 인증은 필요하지 않으며 인증 키는 입력으로 포함되지 않습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 |
| 머리글 | ehstorbandmgmt.h(EhStorBandMgmt.h 포함) |