共用方式為


IOCTL_POINT_OF_SERVICE_RETAIN_DEVICE IOCTL (pointofservicedriverinterface.h)

當用戶端收到另一個用戶端在裝置上宣告的競爭通知時,這個 I/O 控制函式可用來在裝置上保留宣告。

主要程序代碼

IRP_MJ_DEVICE_CONTROL

輸入緩衝區

未與這項作業搭配使用;設定為 NULL

輸入緩衝區長度

未與這項作業搭配使用;設定為 0 (零) 。

輸出緩衝區

未與這項作業搭配使用;設定為 NULL

輸出緩衝區長度

未與這項作業搭配使用;設定為 0 (零)

狀態區塊

如果成功,則傳回 TRUE ;否則會傳回 FALSE

備註

若要取得擴充的錯誤資訊,請呼叫 GetLastError。 下列清單顯示常見的錯誤值:

  • STATUS_ACCESS_DENIED:裝置目前由另一個用戶端宣告。

  • STATUS_DEVICE_NOT_READY:POS 連結庫尚未成功初始化。

只有在用戶端先前已 呼叫 IOCTL_POINT_OF_SERVICE_CLAIM_DEVICE 時,此 IOCTL 才有效。

處理此 IOCTL 時,驅動程式可以呼叫 PosCxRetainDevice。 驅動程式寫入器不需要處理宣告爭用,因為 PosCx 連結庫會決定誰取得宣告。

規格需求

需求
標頭 pointofservicedriverinterface.h (include Pointofservicedriverinterface.h)