NdisCoOidRequestComplete 函式 (ndis.h)

發行項
02/26/2024

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)