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 的呼叫不是列印作業專屬的。 在埠監視器 的 OpenPort 和 ClosePort 函式的每個呼叫之間，可以有多個 呼叫其 StartDocPort 和 EndDocPort 函式。

您可以假設在列印後台處理程式已使用特定埠名稱呼叫 OpenPort 之後，在呼叫 ClosePort 之前，它不會再次使用相同的埠名稱呼叫 OpenPort。

列印接受埠句柄做為輸入的監視器函式，也不會接受監視句柄。 因此， OpenPort 函式必須將接收的監視句柄儲存在埠句柄可參考的位置。 這可讓接受埠句柄的函式參考監視句柄。

規格需求

需求 值
目標平台 桌面
標頭 winsplp.h (包含 Winsplp.h)
程式庫 NtosKrnl.exe

另請參閱

GetPrinterDataFromPort

SetPortTimeOuts

ClosePort

StartDocPort

OpenPortEx

InitializePrintMonitor2

WritePort

EndDocPort

ReadPort