IOCTL_SERIAL_XOFF_COUNTER IOCTL(ntddser.h)

  • 아티클

IOCTL_SERIAL_XOFF_COUNTER 요청은 XOFF 카운터를 설정합니다. XOFF 카운터 요청은 소프트웨어를 사용하여 하드웨어 핸드셰이크 흐름 제어를 에뮬레이트하는 클라이언트를 지원합니다.

XOFF 카운터 요청은 쓰기 요청과 동기화됩니다. 드라이버는 지정된 XOFF 문자를 보내고 다음 이벤트 중 하나가 발생한 후 요청을 완료합니다.

  • 쓰기 요청이 수신됩니다.
  • 타이머가 만료됩니다(시간 제한 값은 XOFF 카운터 요청에 의해 지정됨).
  • 직렬 컨트롤러 드라이버는 XOFF 카운터 요청에 지정된 개수보다 크거나 같은 문자를 받습니다.
XOFF 카운터의 작업에 대한 자세한 내용은 Microsoft WDK(Windows 드라이버 키트)의 Ntddser.h 헤더 파일에서 SERIAL_XOFF_COUNTER 구조에 대한 설명을 참조하세요.

주 코드

IRP_MJ_DEVICE_CONTROL

입력 버퍼

ASSOCIATedIrp.SystemBuffer는 XOFF 카운터 정보를 입력하는 데 사용되는 클라이언트 할당 SERIAL_XOFF_COUNTER 구조를 가리킵니다.

입력 버퍼 길이

Parameters.DeviceIoControl.InputBufferLength는 SERIAL_XOFF_COUNTER 구조체의 크기(바이트)로 설정됩니다.

출력 버퍼

없음

출력 버퍼 길이

없음

상태 블록

정보 멤버가 0으로 설정됩니다.

Status 멤버는 직렬 디바이스 제어 요청에 대한 일반 상태 값 중 하나 또는 다음 요청별 값 중 하나로 설정됩니다.

STATUS_INVALID_PARAMETER

XOFF 카운터 요청에 대해 지정된 개수 값이 0보다 작습니다.

STATUS_SERIAL_COUNTER_TIMEOUT

요청 시간이 초과된 경우

STATUS_SERIAL_MORE_WRITES

쓰기 요청이 수신되었습니다.

요구 사항

요구 사항 값
헤더 ntddser.h(Ntddser.h 포함)

추가 정보

IOCTL_SERIAL_SET_XOFF

IOCTL_SERIAL_SET_XON