SERCX2_CUSTOM_TRANSMIT_CONFIG 구조체(sercx.h)

아티클
08/07/2023

SERCX2_CUSTOM_TRANSMIT_CONFIG 구조에는 SerCx2(직렬 프레임워크 확장) 버전 2가 새 사용자 지정 전송 개체를 구성하는 데 사용하는 정보가 포함되어 있습니다.

구문

typedef struct _SERCX2_CUSTOM_TRANSMIT_CONFIG {
  ULONG   Size;
  ULONG   Alignment;
  ULONG   MinimumTransactionLength;
  ULONG   MaximumTransactionLength;
  ULONG   MinimumTransferUnit;
  BOOLEAN Exclusive;
} SERCX2_CUSTOM_TRANSMIT_CONFIG, *PSERCX2_CUSTOM_TRANSMIT_CONFIG;

멤버

Size

이 구조체의 크기(바이트)입니다. SerCx2CustomTransmitCreate 메서드는 이 멤버를 사용하여 호출자가 사용하는 구조체의 버전을 확인합니다. 이 구조체의 크기는 이후 버전의 Sercx.h 헤더 파일에서 변경될 수 있습니다.

Alignment

데이터 맞춤 요구 사항. 사용자 지정 전송 트랜잭션에서 전송의 시작 주소를 메모리에 맞추는 방법을 지정합니다. 이 멤버를 Wdm.h 헤더 파일의 적절한 FILE_XXX_ALIGNMENT 상수로 설정합니다. 예를 들어 FILE_WORD_ALIGNMENT 시작 주소가 메모리의 2 바이트 경계에 정렬되어야 하며, FILE_LONG_ALIGNMENT 주소가 4 바이트 경계에 정렬되어야 했음을 나타냅니다.

MinimumTransactionLength

사용자 지정 전송 트랜잭션에서 데이터 전송의 최소 길이(바이트)입니다. 쓰기(IRP_MJ_WRITE) 요청의 버퍼 길이가 이 최소 길이보다 작은 경우 SerCx2는 트랜잭션에 프로그래밍된 I/O(PIO)를 사용합니다.

MaximumTransactionLength

사용자 지정 전송 트랜잭션에서 데이터 전송의 최대 길이(바이트)입니다. 쓰기 요청의 버퍼 크기가 이 최대 길이보다 큰 경우 SerCx2는 여러 사용자 지정 전송 트랜잭션을 사용하여 요청을 처리하고 각 트랜잭션을 최대 길이로 제한합니다.

MinimumTransferUnit

최소 전송 단위입니다. 사용자 지정 전송 트랜잭션에서 전송할 바이트 수는 최소 전송 단위의 정수 배수여야 합니다. 기본 최소 전송 단위를 사용해야 함을 나타내려면 이 멤버를 0으로 설정합니다. 기본 최소 전송 단위에 대한 자세한 내용은 DMA_ADAPTER_INFO_V1.

Exclusive

사용자 지정 전송 트랜잭션을 단독으로 사용하여 쓰기(IRP_MJ_WRITE) 요청을 처리할지 여부입니다. 쓰기 요청이 사용자 지정 전송 트랜잭션을 독점적으로 사용해야 함을 나타내려면 TRUE 로 설정합니다. 쓰기 요청이 사용자 지정 전송 트랜잭션과 PIO 전송 트랜잭션의 조합을 사용할 수 있음을 나타내려면 FALSE 로 설정합니다.

사용자 지정 전송 트랜잭션의 최소 전송 단위가 1 바이트이고, 최소 트랜잭션 길이가 1 바이트이고, 트랜잭션에 대한 쓰기 버퍼가 메모리의 바이트 경계에서 시작될 수 있는 경우에만 이 멤버를 TRUE 로 설정합니다.

Exclusive이 TRUE이면 MinimumTransferUnit, Alignment 및 MinimumTransactionLength 멤버는 0이어야 합니다.

설명

SerCx2CustomTransmitCreate 메서드는 SERCX2_CUSTOM_TRANSMIT_CONFIG 구조체에 대한 포인터를 입력 매개 변수로 허용합니다. SerCx2CustomTransmitCreate를 호출하기 전에 SERCX2_CUSTOM_TRANSMIT_CONFIG_INIT 함수를 호출하여 이 구조를 초기화합니다.