處理 CoNDIS WAN Miniport 驅動程式中的查詢
本主題提供在 CoNDIS WAN 迷你埠驅動程式中處理查詢的需求概觀。 上層驅動程式會使用查詢要求呼叫 NdisCoOidRequest ,以判斷 CoNDIS WAN 迷你埠驅動程式和迷你埠驅動程式的 NIC 的 WAN 特定功能和目前狀態。
在 NDISWAN 中繼驅動程式轉送查詢要求之後,NDIS 會呼叫迷你埠驅動程式的 MiniportCoOidRequest 函式。 在 CoNDIS WAN 迷你埠驅動程式中,此函式與任何連線導向迷你埠驅動程式相同,不同之處在于 CoNDIS WAN 迷你埠驅動程式支援 CoNDIS WAN 物件。
如果 CoNDIS WAN 迷你埠驅動程式透過傳回NDIS_STATUS_PENDING的狀態以非同步方式完成 MiniportCoOidRequest ,則稍後必須呼叫 NdisCoOidRequestComplete來完成查詢。
當 NDIS 呼叫 MiniportCoOidRequest時,NDIS 會將指標傳遞至包含查詢 OID 的 NDIS_OID_REQUEST 結構,以及用來保存從迷你埠驅動程式擷取的資訊緩衝區。 迷你埠驅動程式會控制此緩衝區,直到要求完成為止。 如果 NDIS_OID_REQUEST InformationBufferLength 成員中指定的位元組數目不足,則 OID 所需的資訊,迷你埠驅動程式應該會失敗查詢要求,並將 NDIS_OID_REQUEST 的 BytesNeeded 成員設定為 OID 所需的位元組數目。
在目前的查詢要求完成之前,不會將其他要求提交至特定的 WAN 迷你埠驅動程式。
下表摘要說明用來取得或設定 CoNDIS WAN 迷你埠驅動程式作業特性的 OID。
名稱 | 選擇性或必要 |
---|---|
OID_WAN_CO_GET_INFO 取得) (VM 的虛擬連線相關資訊。 | 必要 |
OID_WAN_CO_GET_LINK_INFO 取得 VC 的相關資訊。 | 必要 |
OID_WAN_CO_GET_STATS_INFO 取得 VC 的統計資料資訊。 | 選擇性 |
CoNDIS WAN 迷你埠驅動程式可以支援所有 NDIS 一般物件。 若要深入瞭解在 CoNDIS 迷你埠驅動程式中設定資訊,請參閱 查詢或設定資訊。