共用方式為

OID_GEN_ISOLATION_PARAMETERS

  • 發行項

NDIS 和過度配置驅動程式會發出物件識別碼， (OID) 要求OID_GEN_ISOLATION_PARAMETERS取得在 VM 網路介面卡埠上設定的多租使用者設定 (隔離) 參數。

雖然每個路由網域都是在埠上個別設定，但此 OID 會傳回單一查詢中所有路由網域的參數。

過度處理驅動程式應該在兩個步驟中發出此 OID：

  1. Io 查詢所需的緩衝區大小，發出 OID 查詢，並將NDIS_ISOLATION_PARAMETERS結構的Header成員Size成員設定為NDIS_SIZEOF_NDIS_ISOLATION_PARAMETERS_REVISION_1。 (請參閱下面的 NDIS_STATUS_INVALID_LENGTH 。)
  2. 以所需大小的 InformationBuffer 發出 OID。

如果 OID 查詢要求成功完成，NDIS_OID_REQUEST結構的InformationBuffer成員會包含緩衝區的指標。 此緩衝區包含下列資料，依序：

  1. NDIS_ISOLATION_PARAMETERS結構

  2. 一或多個 NDIS_ROUTING_DOMAIN_ENTRY 結構，每個路由網域各一個

  3. 一或多個 NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY 結構，依路由網域分組

在每個NDIS_ROUTING_DOMAIN_ENTRY結構中，FirstIsolationInfoEntryOffset成員包含 OID 資訊緩衝區開頭 (位移，也就是NDIS_OID_REQUEST結構InformationBuffer成員指向) 該路由網域第一個NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY的緩衝區開頭。 清單中最後一個結構 之 NextIsolationInfoEntryOffset 成員中的位移為零。

如果 VM 網路介面卡上未設定多租使用者設定參數，網路介面卡迷你埠驅動程式會設定DATA。QUERY_INFORMATION。NDIS_OID_REQUEST 結構的 BytesWritten成員為零，並傳回NDIS_STATUS_SUCCESS。 在此情況下， DATA 中的資料。QUERY_INFORMATION。Miniport 驅動程式不會修改 InformationBuffer 成員。

備註

傳回狀態碼

VM 網路介面卡迷你埠驅動程式會針對此 OID 要求傳回下列其中一個狀態碼：

狀態碼 描述

NDIS_STATUS_SUCCESS

OID 要求已順利完成。

NDIS_STATUS_INVALID_LENGTH

資訊緩衝區的長度太小，無法傳回要求的資訊。 VM 網路介面卡迷你埠驅動程式會設定資料。METHOD_INFORMATION。NDIS_OID_REQUEST 結構中的 BytesNeeded成員到所需的最小緩衝區大小，以位元組為單位。

NDIS_STATUS_FAILURE

要求因其他原因而失敗。

規格需求

版本

NDIS 6.40 和更新版本支援。

標頭

 Ntddndis.h (包含 Ndis.h)

另請參閱

NDIS_ISOLATION_PARAMETERS

NDIS_OID_REQUEST

NDIS_ROUTING_DOMAIN_ENTRY

NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY

NDIS_STATUS_ISOLATION_PARAMETERS_CHANGE