NdisCompleteBindAdapterEx 函式 (ndis.h)
通訊協議驅動程式會呼叫 NdisCompleteBindAdapterEx 函式,以完成驅動程式的 ProtocolBindAdapterEx 函式傳回NDIS_STATUS_PENDING的系結作業。
語法
void NdisCompleteBindAdapterEx(
NDIS_HANDLE BindAdapterContext,
[in] NDIS_STATUS Status
);
參數
BindAdapterContext
NDIS 傳遞至 之 BindContext 參數的句柄 ProtocolBindAdapterEx 函 式。
[in] Status
已完成系結作業的最終狀態。 此參數可以是下列其中一個值:
NDIS_STATUS_SUCCESS
驅動程式已成功完成對基礎 NIC 的系結。
NDIS_STATUS_XXX或NTSTATUS_XXX
通訊協定驅動程式嘗試設定系結失敗,或通訊協定驅動程式無法配置執行網路 I/O 作業所需的資源。 通常,這類錯誤狀態會從 NdisXxx 函式或內核模式支援例程傳播。
傳回值
無
備註
如果通訊協議驅動程式從其 ProtocolBindAdapterEx 函式傳回NDIS_STATUS_PENDING,該驅動程式必須在系結作業完成之後呼叫 NdisCompleteBindAdapterEx 。
如果開啟作業成功,通訊協定驅動程式便已準備好接受來自基礎驅動程式的指示,並起始系結上的傳送要求和 OID 要求。 如果驅動程式呼叫 NdisCompleteBindAdapterEx 並出現錯誤狀態,系結嘗試會失敗,而且驅動程式已釋放它配置的任何資源來建立系結。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | NDIS 6.0 和更新版本支援。 |
目標平台 | 桌面 |
標頭 | ndis.h (包含 Ndis.h) |
程式庫 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 合規性規則 | Irql_Protocol_Driver_Function () |