다음을 통해 공유


OpenPort 함수(winsplp.h)

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

통사론

BOOL OpenPort(
  LPWSTR  pName,
  PHANDLE pHandle
);

매개 변수

pName

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

pHandle

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

반환 값

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

발언

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

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

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

OpenPort 호출은 작업별로 인쇄되지 않습니다. 포트 모니터의 OpenPortClosePort 함수에 대한 각 호출 사이에는 StartDocPortEndDocPort 함수에 대한 여러 호출이 있을 수 있습니다.

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

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

요구 사항

요구
대상 플랫폼 바탕 화면
헤더 winsplp.h(Winsplp.h 포함)
라이브러리 NtosKrnl.exe

참고 항목

GetPrinterDataFromPort

SetPortTimeOuts

ClosePort

startDocPort

OpenPortEx

InitializePrintMonitor2

WritePort

endDocPort

ReadPort