OID_SWITCH_PROPERTY_ENUM
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 クエリ要求とは異なり、拡張機能は、拡張可能スイッチ ドライバー スタックのOID_SWITCH_PROPERTY_ENUM 要求を発行するときに、 ReferenceSwitchXxx または DereferenceSwitchXxx 関数を呼び出す必要はありません。
注 拡張機能は、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 要素の配列が返されるには小さすぎます。 拡張可能スイッチの下位ミニポート エッジは、 NDIS_OID_REQUEST 構造体の DATA.METHOD_INFORMATION.BytesNeeded メンバーに必要最小限のバッファーを設定します。 |
NDIS_STATUS_FAILURE |
その他の理由で要求に失敗しました。 |
要件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダー |
Ntddndis.h (Ndis.h を含む) |
関連項目
NDIS_SWITCH_PROPERTY_ENUM_INFO