NDIS 和過度配置驅動程式發出OID_GEN_ISOLATION_PARAMETERS的物件識別碼 (OID) 要求,以取得 VM 網路適配器埠上設定的多租用戶組態(隔離)參數。
雖然每個路由網域都是在埠上個別設定,但此 OID 會傳回單一查詢中所有路由網域的參數。
過度的驅動程式應該在兩個步驟中發出此 OID:
- Io 查詢所需的緩衝區大小,發出 OID 查詢,並將 Size 成員 標頭NDIS_ISOLATION_PARAMETERS 結構的成員設為 NDIS_SIZEOF_NDIS_ISOLATION_PARAMETERS_REVISION_1。 (請參閱下面的 NDIS_STATUS_INVALID_LENGTH。
- 使用所需大小的 InformationBuffer 發出 OID。
如果 OID 查詢要求成功完成,InformationBufferNDIS_OID_REQUEST 結構的成員包含緩衝區的指標。 此緩衝區包含下列資料,依序排列:
一或多個 NDIS_ROUTING_DOMAIN_ENTRY 結構,每個路由網域各一個
一或多個 NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY 結構,依路由網域分組
在每個 NDIS_ROUTING_DOMAIN_ENTRY 結構中,FirstIsolationInfoEntryOffset 成員包含 OID 資訊緩衝區開頭的位移(也就是 InformationBufferNDIS_OID_REQUEST 結構成員所指向的緩衝區開頭)到該路由網域的第一個 NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY。 NextIsolationInfoEntryOffset 中的位移 列表中最後一個結構的成員為零。
如果 VM 網路適配器上未設定任何多租使用者組態參數,網路適配器迷你埠驅動程式會設定 DATA。QUERY_INFORMATION。BytesWrittenNDIS_OID_REQUEST 結構的成員設為零,並傳回 NDIS_STATUS_SUCCESS。 在此情況下,DATA 中的數據。QUERY_INFORMATION。miniport 驅動程式不會修改 InformationBuffer 成員。
言論
傳回狀態代碼
VM 網络適配器迷你埠驅動程式會針對此 OID 要求傳回下列其中一個狀態代碼:
狀態代碼 | 描述 |
---|---|
NDIS_STATUS_SUCCESS |
OID 要求已順利完成。 |
NDIS_STATUS_INVALID_LENGTH |
信息緩衝區的長度太小,無法傳回要求的資訊。 VM 網路配接器迷你埠驅動程式會設定 數據。METHOD_INFORMATION。BytesNeededNDIS_OID_REQUEST 結構中的成員,以位元組為單位,以位元組為單位。 |
NDIS_STATUS_FAILURE |
要求因其他原因而失敗。 |
要求
版本 |
NDIS 6.40 和更新版本支援。 |
頁眉 |
Ntddndis.h (包括 Ndis.h) |