OID_GEN_ISOLATION_PARAMETERS
NDIS および上にあるドライバーは、VM ネットワーク アダプターのポートに設定されているマルチテナント構成 (分離) パラメーターを取得するための OID_GEN_ISOLATION_PARAMETERS のオブジェクト識別子 (OID) 要求を発行します。
各ルート指定ドメインはポートで個別に構成されますが、この OID は、単一のクエリ内のすべてのルート指定ドメインのパラメーターを返します。
上にあるドライバーは、次の 2 つの手順でこの OID を発行する必要があります。
- Io は、必要なバッファー サイズを照会し、NDIS_ISOLATION_PARAMETERS 構造体の Header メンバーの Size メンバーを NDIS_SIZEOF_NDIS_ISOLATION_PARAMETERS_REVISION_1 に設定して OID クエリを発行します。 (下記の NDIS_STATUS_INVALID_LENGTH を参照してください。)
- 必要なサイズの InformationBuffer で OID を発行します。
OID クエリ要求が正常に完了した場合、NDIS_OID_REQUEST 構造体の InformationBuffer メンバーにはバッファーへのポインターが含まれます。 このバッファーには、次のデータが順に格納されています。
1 つ以上の NDIS_ROUTING_DOMAIN_ENTRY 構造体、ルート指定ドメインごとに 1 つ
ルート指定ドメインによってグループ化された 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 を含む) |