OID_GEN_ISOLATION_PARAMETERS

  • [アーティクル]

NDIS および上にあるドライバーは、VM ネットワーク アダプターのポートに設定されているマルチテナント構成 (分離) パラメーターを取得するための OID_GEN_ISOLATION_PARAMETERS のオブジェクト識別子 (OID) 要求を発行します。

各ルート指定ドメインはポートで個別に構成されますが、この OID は、単一のクエリ内のすべてのルート指定ドメインのパラメーターを返します。

上にあるドライバーは、次の 2 つの手順でこの OID を発行する必要があります。

  1. Io は、必要なバッファー サイズを照会し、NDIS_ISOLATION_PARAMETERS 構造体の Header メンバーの Size メンバーを NDIS_SIZEOF_NDIS_ISOLATION_PARAMETERS_REVISION_1 に設定して OID クエリを発行します。 (下記の NDIS_STATUS_INVALID_LENGTH を参照してください。)
  2. 必要なサイズの InformationBuffer で OID を発行します。

OID クエリ要求が正常に完了した場合、NDIS_OID_REQUEST 構造体の InformationBuffer メンバーにはバッファーへのポインターが含まれます。 このバッファーには、次のデータが順に格納されています。

  1. NDIS_ISOLATION_PARAMETERS 構造体

  2. 1 つ以上の NDIS_ROUTING_DOMAIN_ENTRY 構造体、ルート指定ドメインごとに 1 つ

  3. ルート指定ドメインによってグループ化された 1 つ以上の NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY 構造体

各 NDIS_ROUTING_DOMAIN_ENTRY 構造体で、FirstIsolationInfoEntryOffset メンバーには、OID 情報バッファーの先頭 (つまり、NDIS_OID_REQUEST 構造体の InformationBuffer メンバーが指すバッファーの先頭) からそのルート指定ドメインの最初の NDIS_ROUTING_DOMAIN_ISOLATION_ENTRY までのオフセットが含まれます。 リスト内の最後の構造体の NextIsolationInfoEntryOffset メンバーのオフセットは 0 です。

VM ネットワーク アダプターでマルチテナント構成パラメーターが設定されていない場合、ネットワーク アダプター ミニポート ドライバーは NDIS_OID_REQUEST 構造体の DATA.QUERY_INFORMATION.BytesWritten メンバーを 0 に設定し、NDIS_STATUS_SUCCESS を返します。 この場合、DATA.QUERY_INFORMATION.InformationBuffer メンバー内のデータはミニポート ドライバーによって変更されません。

解説

状態コードを返す

VM ネットワーク アダプター ミニポート ドライバーは、この OID 要求の次の状態コードのいずれかを返します。

状態コード 説明

NDIS_STATUS_SUCCESS

OID 要求は正常に完了しました。

NDIS_STATUS_INVALID_LENGTH

情報バッファーの長さが小さすぎて、要求された情報が返されません。 VM ネットワーク アダプター ミニポート ドライバーは、NDIS_OID_REQUEST 構造体の DATA.METHOD_INFORMATION.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