IOCTL_SERENUM_GET_PORT_NAME IOCTL(ntddser.h)

IOCTL_SERENUM_GET_PORT_NAME 요청은 RS-232 포트에 대한 PortName(또는 식별자) 항목 값의 값을 반환합니다. 플러그 앤 플레이 직렬 디바이스에 대한 레지스트리 설정을 참조하세요.

주 코드

IRP_MJ_DEVICE_CONTROL

입력 버퍼

없음

입력 버퍼 길이

없음

출력 버퍼

ASSOCIATedIrp.SystemBuffer 멤버는 Serenum이 포트 이름을 출력하는 데 사용하는 클라이언트 할당 버퍼를 가리킵니다. 포트 이름은 null로 끝나는 유니코드 문자열입니다.

출력 버퍼 길이

Parameters.DeviceIoControl.OutputBufferLength 멤버는 클라이언트 할당 출력 버퍼의 크기(바이트)로 설정됩니다.

상태 블록

요청이 성공하면 정보 멤버는 클라이언트의 출력 버퍼에 반환되는 null로 종료된 유니코드 문자열의 크기(바이트)로 설정됩니다.

Status 멤버는 다음 값 중 하나로 설정됩니다.

STATUS_BUFFER_TOO_SMALL

출력 버퍼가 너무 작아서 포트 이름 문자열을 보유할 수 없습니다.

STATUS_SUCCESS

요청이 성공적으로 완료되었습니다.

STATUS_UNSUCCESSFUL

디바이스의 레지스트리 키를 열거나 PortName (또는 식별자) 항목 값을 읽을 때 오류가 발생했습니다.

요구 사항