CoNDIS MCM OID 要求

就像其他 CoNDIS 通話管理員一樣，迷你埠通話管理員 (MC) 可以查詢或設定 CoNDIS 用戶端驅動程式的作業參數。 CoNDIS 用戶端驅動程式可以查詢或設定呼叫管理員參數或 MCM 的迷你埠驅動程式參數。

為了向 CoNDIS 用戶端驅動程式產生 OID 要求，MCM 會呼叫 NdisMCmOidRequest 函式。

下圖說明 MCM 源自的 OID 要求。

MCM 驅動程式呼叫 NdisMCmOidRequest 函式之後，NDIS 會呼叫用戶端驅動程式的 ProtocolCoOidRequest 函式。

若要同步完成， NdisMCmOidRequest 會傳回NDIS_STATUS_SUCCESS或錯誤狀態。 若要以非同步方式完成， NdisMCmOidRequest 會傳回NDIS_STATUS_PENDING。

如果NdisMCmOidRequest傳回NDIS_STATUS_PENDING，NDIS 會在用戶端驅動程式呼叫NdisCoOidRequestComplete 函式完成 OID 要求之後，呼叫 NdisCoOidRequestComplete函式。 在此情況下，NDIS 會在ProtocolCoOidRequestComplete的OidRequest參數傳遞要求的結果。 NDIS 會在ProtocolCoOidRequestComplete的Status參數傳遞要求的最終狀態。

如果NdisMCmOidRequest傳回NDIS_STATUS_SUCCESS，它會在OidRequest參數的NDIS_OID_REQUEST結構中傳回查詢要求的結果。 在此情況下，NDIS 不會呼叫 MCM 的 ProtocolCoOidRequestComplete 函式。

CoNDIS 用戶端驅動程式可以查詢或設定 MCM 的呼叫管理員作業參數或迷你埠作業參數。 為了產生 MCM 呼叫管理員參數的 OID 要求，用戶端會呼叫 NdisCoOidRequest 函式，並在 NdisAfHandle 參數提供有效的位址系列 (AF) 控制碼。 為了產生 MCM 迷你埠參數的 OID 要求，用戶端會呼叫 NdisCoOidRequest 函式，並將 AF 控制碼設定為 Null。

在用戶端呼叫 NdisCoOidRequest 函式之後，NDIS 會呼叫 MiniportCoOidRequest 函式或 MCM 驅動程式的 ProtocolCoOidRequest 函式。

下圖說明 MCM 迷你埠參數的 OID 要求。

下圖說明 MCM 呼叫管理員參數的 OID 要求。

若要同步完成， NdisCoOidRequest 會傳回NDIS_STATUS_SUCCESS或錯誤狀態。 若要以非同步方式完成， ProtocolCoOidRequest 或 MiniportCoOidRequest 會傳回NDIS_STATUS_PENDING。

如果 ProtocolCoOidRequest 或 MininportCoOidRequest 傳回NDIS_STATUS_PENDING，NDIS 會在 MCM 呼叫用戶端的 ProtocolCoOidRequestComplete 函式，方法是呼叫 NdisMCoOidRequestComplete 或 NdisMCmOidRequestComplete 函式來完成 OID 要求。 在此情況下，NDIS 會在ProtocolCoOidRequestComplete的OidRequest參數傳遞要求的結果。 NDIS 會在ProtocolCoOidRequestComplete的Status參數傳遞要求的最終狀態。

如果NdisCoOidRequest傳回NDIS_STATUS_SUCCESS，它會在OidRequest參數的NDIS_OID_REQUEST結構中傳回查詢要求的結果。 在此情況下，NDIS 不會呼叫用戶端的 ProtocolCoOidRequestComplete 函式。