NdisCoOidRequestComplete 函式 (ndis.h)
NdisCoOidRequestComplete 函式會傳回 OID 要求的最終狀態,這是 CoNDIS 用戶端或獨立呼叫管理員的 ProtocolCoOidRequest 函式先前傳回的 NDIS_STATUS_PENDING。
語法
void NdisCoOidRequestComplete(
[in] NDIS_HANDLE NdisAfHandle,
[in, optional] NDIS_HANDLE NdisVcHandle,
[in, optional] NDIS_HANDLE NdisPartyHandle,
[in] PNDIS_OID_REQUEST OidRequest,
[in] NDIS_STATUS Status
);
參數
[in] NdisAfHandle
位址系列 (AF) 處理傳遞至用戶端或獨立呼叫管理員的 NDIS ProtocolCoOidRequest 函式。
[in, optional] NdisVcHandle
虛擬連線 (VC) 處理傳遞給用戶端或獨立呼叫管理員的 ProtocolCoOidRequest 函式的 NDIS。 此參數的 NULL 值表示要求不是 VC 特定的。 如果NdisCoOidRequest 或 NdisMCmOidRequest 函式的呼叫端指定 NULL VC 句柄,此參數為 NULL。
[in, optional] NdisPartyHandle
NDIS 傳遞至客戶端或獨立呼叫管理員的 ProtocolCoOidRequest 函式的合作物件句柄。 此參數的 NULL 值表示要求不是特定合作物件。 如果NdisCoOidRequest 或 NdisMCmOidRequest 函式的呼叫端指定 NULL 合作物件句柄,此參數為 NULL。
[in] OidRequest
格式化為 NDIS_OID_REQUEST 結構的緩衝區指標。 NdisCoOidRequest 或 NdisMCmOidRequest 函式的呼叫端提供了此緩衝區。
[in] Status
要求作業的最終狀態,NDIS_STATUS_SUCCESS,或任何驅動程序判斷NDIS_STATUS_XXX 狀態值,但NDIS_STATUS_PENDING除外。
傳回值
無
備註
從其 ProtocolCoOidRequest 函式傳回NDIS_STATUS_PENDING的 CoNDIS 通訊協定驅動程式,必須在通訊協定驅動程式完成要求作業之後呼叫 NdisCoOidRequestComplete 。
驅動程式呼叫 NdisCoOidRequestComplete 之後,NDIS 會呼叫原本稱為 NdisCoOidRequest 或 NdisMCmOidRequest 函式的驅動程式 ProtocolCoOidRequestComplete 函式。
只有向 NDIS 註冊為通訊協定驅動程式的用戶端和獨立呼叫管理員,才能呼叫 NdisCoOidRequestComplete。 (MCM 的迷你埠通話管理員) 呼叫 NdisMCmOidRequestComplete 函式 或視 MCM 驅動程式的 ProtocolCoOidRequest 或 MiniportCoOidRequest 函式而定,NdisMCoOidRequestComplete 會分別處理用戶端的要求。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | NDIS 6.0 和更新版本支援。 |
目標平台 | 桌面 |
標頭 | ndis.h (包括 Ndis.h) |
程式庫 | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
DDI 合規性規則 | Irql_Connection_Function (ndis) |