NdisDeregisterProtocolDriver 函式 (ndis.h)
通訊協議驅動程式會呼叫 NdisDeregisterProtocolDriver 函 式,以釋放驅動程式呼叫 時所配置的 NDIS 資源 NdisRegisterProtocolDriver 函 式。
語法
void NdisDeregisterProtocolDriver(
[in] NDIS_HANDLE NdisProtocolHandle
);
參數
[in] NdisProtocolHandle
所傳回的句柄 NdisRegisterProtocolDriver 函 式。
傳回值
無
備註
已註冊的通訊協定驅動程式通常會在呼叫驅動程式的 Unload 例程或在 DriverEntry 例程發生錯誤之後呼叫 NdisDeregisterProtocolDriver。 通訊協議驅動程式不得從 NDIS 呼叫的任何進入點呼叫 NdisDeregisterProtocolDriver 。 從這類進入點呼叫 NdisDeregisterProtocolDriver 可能會導致死結。
如果通訊協定驅動程式有開啟的系結,則其 對 NdisDeregisterProtocolDriver 的呼叫會導致 NDIS 呼叫通訊協定驅動程式的 ProtocolUnbindAdapterEx 函式一次,用於每個開啟的系結。 NDIS 會在 NdisDeregisterProtocolDriver 呼叫的內容中呼叫 ProtocolUnbindAdapterEx。
關閉任何未完成的系結之後, NdisDeregisterProtocolDriver 會釋放 NDIS 配置來追蹤通訊協定驅動程式系結和篩選的所有資源。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | NDIS 6.0 和更新版本支援。 |
目標平台 | 桌面 |
標頭 | ndis.h (包含 Ndis.h) |
程式庫 | Ndis.lib |
IRQL | PASSIVE_LEVEL |
DDI 合規性規則 | Irql_Protocol_Driver_Function () |