OID_SWITCH_PARAMETERS

  • [アーティクル]

Hyper-V 拡張可能スイッチ拡張機能は、拡張可能スイッチの構成データを取得するO ID_SWITCH_PARAMETERS のオブジェクト識別子 (OID) クエリ要求を発行します。

OID クエリ要求が正常に完了した場合、 NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、 NDIS_SWITCH_PARAMETERS 構造体へのポインターが含まれます。

解説

返された NDIS_SWITCH_PARAMETERS 構造体を拡張機能が処理する場合、 SwitchName など、 NDIS_SWITCH_PARAMETERS 構造体のさまざまな文字列メンバーが null で終わると想定しないでください。 これらの文字列メンバーのデータタイプは、 IF_COUNTED_STRING 構造体によってタイプ定義されます。 拡張機能は、この構造体の Length メンバーの値から文字列の長さを決定する必要があります。

注 文字列が null で終わる場合、 Length メンバーに終端の null 文字を含めてはなりません。

状態コードを返します

拡張可能スイッチの下位ミニポート エッジは、OID_SWITCH_PARAMETERS の OID クエリ要求を完了し、次のいずれかの状態コードを返します。

状態コード 説明

NDIS_STATUS_SUCCESS

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

NDIS_STATUS_INVALID_LENGTH

情報バッファーの長さは、OID クエリ要求の OID_SWITCH_PARAMETERS 構造体を返すにはが小さすぎてます。 拡張可能スイッチの下位ミニポート エッジは、 NDIS_OID_REQUEST 構造体の DATA.QUERY_INFORMATION.BytesNeeded メンバーに必要最小限のバッファーを設定します。

NDIS_STATUS_FAILURE

その他の理由で要求に失敗しました。

要件

バージョン

NDIS 6.30 以降でサポートされています。

ヘッダー

 Ntddndis.h (Ndis.h を含む)

関連項目

NDIS_OID_REQUEST

NDIS_SWITCH_PARAMETERS

NdisFOidRequest