Hyper-V 拡張可能スイッチ拡張機能は、配列を取得するOID_SWITCH_PROPERTY_ENUMのオブジェクト識別子 (OID) メソッド要求を発行します。 この配列には、指定した条件に一致するプロビジョニング済みのスイッチ ポリシーが含まれています。 配列内の各要素は、拡張可能スイッチ ポリシーのプロパティを指定します。
NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、バッファーへのポインターが含まれています。 このバッファーには、次のデータが含まれています。
拡張可能スイッチ ポリシー列挙体のパラメーターを指定する NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 構造体。
NDIS_SWITCH_PROPERTY_ENUM_INFO 構造体の配列。 これらの各構造体には、拡張可能スイッチ ポリシーに関する情報が含まれています。
注 指定した拡張可能スイッチ ポリシーのインスタンスで拡張機能がプロビジョニングされていない場合、拡張機能は、NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 構造体のメンバー numProperties を 0 に設定し、NDIS_SWITCH_PROPERTY_ENUM_INFO 構造体は返されません。
備考
OID_SWITCH_PROPERTY_ENUM OID は、Hyper-V 拡張可能スイッチがアクティブ化を完了した場合にのみ発行する必要があります。 詳細については、「Hyper-V 拡張可能スイッチ構成 のクエリを実行する を参照してください。
OID_SWITCH_PORT_PROPERTY_ENUMの OID クエリ要求とは異なり、拡張機能は、ReferenceSwitchXxx または dereferenceSwitchXxx 関数 呼び出す必要はありません。これは、拡張可能スイッチ ドライバー スタックでOID_SWITCH_PROPERTY_ENUM要求を発行する場合です。
注 拡張機能がOID_SWITCH_PROPERTY_ENUMの OID メソッド要求を受信した場合、OID 要求を完了してはなりません。 代わりに、NDISFOidRequest呼び出して、拡張可能スイッチ ドライバー スタックに OID 要求を転送する必要があります。
戻り値の状態コード
拡張可能スイッチの基になるミニポート エッジは、OID_SWITCH_PROPERTY_ENUMの OID クエリ要求を完了し、次のいずれかの状態コードを返します。
| 状態コード | 形容 |
|---|---|
NDIS_STATUS_SUCCESS |
OID 要求が正常に完了しました。 |
NDIS_STATUS_INVALID_LENGTH |
情報バッファーの長さが小さすぎて、NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS 構造体とその NDIS_SWITCH_PROPERTY_ENUM_INFO 要素の配列が返されます。 拡張可能スイッチの基になるミニポート エッジは、DATA を設定します。METHOD_INFORMATION。BytesNeededNDIS_OID_REQUEST 構造体のメンバーを、必要な最小バッファー サイズに設定します。 |
NDIS_STATUS_FAILURE |
その他の理由で要求が失敗しました。 |
必要条件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダ |
Ntddndis.h (Ndis.h を含む) |
関連項目
NDIS_SWITCH_PROPERTY_ENUM_INFO
NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS
Hyper-V 拡張可能スイッチ構成 のクエリの