OpenPort 함수(winsplp.h)

아티클
02/06/2022
읽는 데 3분 걸림

포트 모니터의 OpenPort 함수가 프린터 포트를 엽니다.

구문

BOOL WINAPI pfnOpenPort(
   HANDLE  hMonitor,
   LPWSTR  pName,
   PHANDLE pHandle
);

매개 변수

pName

열 포트의 이름을 포함하는 문자열에 대한 호출자 제공 포인터입니다.

pHandle

포트 핸들을 받을 위치에 대한 호출자 제공 포인터입니다.

반환 값

작업이 성공하면 함수는 TRUE를 반환해야 합니다. 그렇지 않으면 FALSE를 반환해야 합니다.

설명

포트 모니터 서버 DLL은 함수를 OpenPort 정의하고 MONITOR2 구조에 함수의 주소를 포함하는 데 필요합니다.

OpenPort 이 함수는 인쇄 큐가 포트에 연결될 때 언어 모니터 또는 인쇄 스풀러에 의해 호출됩니다. 이 OpenPort 함수의 주요 목적은 호출자가 포트 모니터의 StartDocPort, WritePort, ReadPort, EndDocPort 및 GetPrinterDataFromPort 함수에 대한 후속 호출에 대한 입력 인수로 사용할 수 있는 포트 핸들을 반환하는 것입니다.

포트 핸들을 반환하는 것 외에도 함수는 OpenPort 읽기 또는 쓰기 작업을 수행하기 전에 처리해야 하는 초기화 작업을 수행할 수 있습니다. 예를 들어 포트에서 수정 가능한 제한 시간 값을 지원하는 경우 함수는 OpenPort 이러한 값을 설정해야 합니다.

OpenPort 호출은 작업별로 인쇄되지 않습니다. 포트 모니터 OpenPort 와 ClosePort 함수에 대한 각 호출 사이에 StartDocPort 및 EndDocPort 함수에 대한 여러 호출이 있을 수 있습니다.

인쇄 스풀러가 특정 포트 이름으로 호출 OpenPort 된 후 ClosePort를 호출하기 전에 동일한 포트 이름으로 다시 호출 OpenPort 되지 않는다고 가정할 수 있습니다.

포트 핸들을 입력으로 허용하는 인쇄 모니터 함수도 모니터 핸들을 허용하지 않습니다. 따라서 함수는 OpenPort 수신된 모니터 핸들을 포트 핸들에서 참조할 수 있는 위치에 저장해야 합니다. 이렇게 하면 포트 핸들을 허용하는 함수가 모니터 핸들을 참조할 수 있습니다.