EVT_POS_CX_DEVICE_REMOTE_RETAIN回呼函式 (poscx.h)

每當 PosCx 嘗試保留網路裝置上的宣告，並允許驅動程式執行額外的工作時，就會呼叫EVT_POS_CX_DEVICE_REMOTE_RETAIN回呼。 此回呼通常只會與需要額外邏輯來處理擁有權轉換的網路連線裝置搭配使用。

語法

EVT_POS_CX_DEVICE_REMOTE_RETAIN EvtPosCxDeviceRemoteRetain;

NTSTATUS EvtPosCxDeviceRemoteRetain(
  [in] WDFDEVICE device,
  [in] ULONG deviceInterfaceTag
)
{...}

參數

[in] device

代表裝置之架構裝置物件的句柄。

[in] deviceInterfaceTag

用來指定在多函式裝置中保留哪個介面的標識碼。 對於單一介面裝置，此值應該是 0。

傳回值

如果作業成功，回呼函式必須傳回STATUS_SUCCESS或NT_SUCCESS (状态) 等於 TRUE 的另一個狀態值。

如果驅動程式無法完成遠端保留交易，它應該會傳回STATUS_ACCESS_DENIED，讓失敗會反升至應用程式。

規格需求

需求	值
目標平台	Windows
標頭	poscx.h (包含 Poscx.h)