SERCX_ACTIVITY 구조체(sercx.h)

아티클
02/26/2024

SERCX_ACTIVITY 구조에는 직렬 컨트롤러 드라이버가 처리할 준비가 된 작업 항목의 요약이 포함되어 있습니다.

구문

typedef struct _SERCX_ACTIVITY {
  ULONG   Size;
  BOOLEAN Transmitting;
  BOOLEAN Receiving;
} SERCX_ACTIVITY, *PSERCX_ACTIVITY;

멤버

Size

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

Transmitting

전송(쓰기) 작업이 진행 중인지 여부입니다. 전송 작업이 진행 중인 경우 이 멤버는 TRUE입니다. 그렇지 않으면 FALSE입니다.

Receiving

수신(읽기) 작업이 진행 중인지 여부입니다. 수신 작업이 진행 중인 경우 이 멤버는 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

이 구조체는 처음 사용하기 전에 SERCX_ACTIVITY_INIT 함수에 의해 초기화되어야 합니다. 그 후 SerCxGetActivity 메서드에 대한 호출은 현재 보류 중인 작업을 나타내도록 이 구조체의 내용을 업데이트합니다.

SERCX_ACTIVITY 구조는 SerCx(직렬 프레임워크 확장)가 직렬 컨트롤러 드라이버에 할당하는 보류 중인 작업을 요약합니다. 이 작업은 클라이언트의 I/O 요청에 의해 구동되지만 I/O 요청이 반드시 작업 항목을 생성하지는 않습니다. 예를 들어 SerCx의 메모리 버퍼에 보류 중인 읽기 요청을 완료하기에 충분한 양의 수신된 데이터가 있는 경우 이 요청으로 인해 SERCX_ACTIVITY 구조의 수신 멤버가 TRUE로 설정되지 않습니다.

일반적으로 SerCxGetActivity는 직렬 컨트롤러 드라이버에서 전송/수신 DPC 함수의 기본 루프에서 호출됩니다. 이 함수 는 SerCxGetActivity를 호출하고, 전체 전송 또는 수신 작업을 처리한 다음, SerCxGetActivity 를 다시 호출하여 다른 형식의 작업에 작업이 필요한지 여부를 확인합니다. 더 많은 작업을 사용할 수 있는 경우 DPC 함수는 반환하기 전에 이 작업을 수행할 수 있습니다.