CoNDIS Miniport 驅動程式 OID 要求
NDIS 會呼叫 CoNDIS 迷你埠驅動程式的 MiniportCoOidRequest 函式,以提交 OID 要求來查詢或設定驅動程式中的資訊。 NDIS 代表自己呼叫 MiniportCoOidRequest ,或代表呼叫 NdisCoOidRequest 函式的過度使用驅動程式。
NDIS 會將 MiniportCoOidRequest 指標傳遞給包含要求資訊的 NDIS_OID_REQUEST 結構。 要求結構包含OID_Xxx 識別碼,指出要求類型和要定義要求資料的其他成員。
Timeout成員會指定要求的逾時,以秒為單位。 如果驅動程式在驅動程式完成要求之前逾時到期,NDIS 可以重設驅動程式或取消要求。
RequestId成員會指定要求的選擇性識別碼。 迷你埠驅動程式可以將狀態指示的 RequestId 成員設定為驅動程式從相關聯 OID 要求 之 RequestId 成員取得的值。 一般而言,迷你埠驅動程式可以忽略此成員。 如果驅動程式必須設定此成員,驅動程式必須使用其中一個必要值,這些值是在特定 OID 的參考頁面中指定。 如需狀態指示的詳細資訊,請參閱 CoNDIS Miniport 驅動程式狀態指示。
迷你埠驅動程式可以傳回成功或失敗狀態,以同步方式完成 OID 要求。 驅動程式可以傳回 NDIS_STATUS_PENDING,以非同步方式完成 OID 要求。 在此情況下,驅動程式必須呼叫 NdisMCoOidRequestComplete 函式來完成作業。
如果 MiniportCoOidRequest 函式傳回NDIS_STATUS_PENDING,NDIS 可以在暫止要求完成之前,先呼叫 MiniportCoOidRequest 與配接器的另一個要求。 您應該注意,這與序列化所有 OID 要求的無連線 NDIS 介面不同。
NDIS 可以呼叫迷你埠驅動程式的 MiniportCancelOidRequest 函式來取消 CoNDIS OID 要求。