RxFinalizeSrvCall 函式 (fcb.h)

發行項
02/29/2024

RxFinalizeSrvCall 會完成指定的SRV_CALL結構。呼叫端必須在與裝置對象相關聯的 netname 數據表上具有獨佔鎖定。

語法

BOOLEAN RxFinalizeSrvCall(
  [out] OUT PSRV_CALL ThisSrvCall,
  [in]  IN BOOLEAN    ForceFinalize
);

參數

[out] ThisSrvCall

要完成之SRV_CALL結構的指標。

[in] ForceFinalize

值，指出是否應該強制完成，而不論參考計數為何。

如果 ForceFinalize 為 FALSE，則 ThisSrvCall 所指向之SRV_CALL結構的 NodeReferenceCount 成員必須是 1，才能完成SRV_CALL。

傳回值

RxFinalizeSrvCall 會在成功時傳回 TRUE ，如果未發生最終處理，則 傳回 FALSE ：

備註

網路迷你重新導向器驅動程式通常不會直接呼叫 RxFinalizeSrvCall 例程。當 SRV_CALL參考計數遞減為 1 時，RDBSS 會在內部呼叫此例程。 RDBSS 也會在網路迷你重新導向器驅動程式停止或卸除時呼叫 RxFinalizeSrvCall 。

呼叫 RxFinalizeSrvCall 之前，必須以獨佔模式取得與裝置對象相關聯的 netname 數據表鎖定。

如果目前的執行進程標識碼與 RDBSS 進程識別碼相同，則會分派延遲的背景工作線程來終結SRV_CALL結構。此背景工作線程稍後會呼叫網路迷你重新導向器提供的 MRxFinalizeSrvCall 例程，以完成SRV_CALL。否則，系統會直接呼叫 MRxFinalizeSrvCall 例程來完成SRV_CALL。