DEVICE_COPY_OFFLOAD_DESCRIPTOR 구조체(winioctl.h)

DEVICE_COPY_OFFLOAD_DESCRIPTOR 구조는 IOCTL_STORAGE_QUERY_PROPERTY 요청에서 반환된 쿼리 결과 구조 중 하나입니다. 이 구조에는 스토리지 디바이스에 대한 복사 오프로드 기능이 포함되어 있습니다.

구문

typedef struct _DEVICE_COPY_OFFLOAD_DESCRIPTOR {
  DWORD     Version;
  DWORD     Size;
  DWORD     MaximumTokenLifetime;
  DWORD     DefaultTokenLifetime;
  DWORDLONG MaximumTransferSize;
  DWORDLONG OptimalTransferCount;
  DWORD     MaximumDataDescriptors;
  DWORD     MaximumTransferLengthPerDescriptor;
  DWORD     OptimalTransferLengthPerDescriptor;
  WORD      OptimalTransferLengthGranularity;
  BYTE      Reserved[2];
} DEVICE_COPY_OFFLOAD_DESCRIPTOR, *PDEVICE_COPY_OFFLOAD_DESCRIPTOR;

멤버

Version

이 구조체의 크기(바이트)를 포함합니다. 멤버가 구조체에 추가되면 이 멤버의 값이 변경됩니다.

Size

반환된 데이터의 총 크기(바이트)를 지정합니다. 여기에는 이 구조를 따르는 데이터가 포함될 수 있습니다.

MaximumTokenLifetime

토큰의 최대 수명(초)입니다.

DefaultTokenLifetime

토큰의 기본 수명(초)입니다.

MaximumTransferSize

최대 전송 크기(바이트)입니다.

OptimalTransferCount

최적의 전송 크기(바이트)입니다.

MaximumDataDescriptors

최대 데이터 설명자 수입니다.

MaximumTransferLengthPerDescriptor

설명자당 최대 전송 길이(블록)입니다.

OptimalTransferLengthPerDescriptor

설명자당 최적의 전송 길이입니다.

OptimalTransferLengthGranularity

최적 전송 길이의 세분성(블록)입니다. 이 길이의 배수가 아닌 전송 길이는 지연될 수 있습니다.

Reserved[2]

예약되어 있습니다.

설명

이 구조체는 STORAGE_PROPERTY_QUERYPropertyId 멤버가 StorageDeviceCopyOffloadProperty로 설정된 경우 IOCTL_STORAGE_QUERY_PROPERTY 요청에서 반환됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱만 해당]
머리글	winioctl.h(Windows.h 포함)

추가 정보

디스크 관리 구조

IOCTL_STORAGE_QUERY_PROPERTY

STORAGE_PROPERTY_QUERY