NDIS_SWITCH_PROPERTY_ENUM_INFO 構造体 (ntddndis.h)

[アーティクル]
08/07/2023

NDIS_SWITCH_PROPERTY_ENUM_INFO構造体は、Hyper-V 拡張可能スイッチのプロファイルプロパティに関する情報を指定します。

構文

typedef struct _NDIS_SWITCH_PROPERTY_ENUM_INFO {
  NDIS_OBJECT_HEADER             Header;
  ULONG                          Flags;
  NDIS_SWITCH_OBJECT_INSTANCE_ID PropertyInstanceId;
  NDIS_SWITCH_OBJECT_VERSION     PropertyVersion;
  ULONG                          QwordAlignedPropertyBufferLength;
  ULONG                          PropertyBufferLength;
  ULONG                          PropertyBufferOffset;
} NDIS_SWITCH_PROPERTY_ENUM_INFO, *PNDIS_SWITCH_PROPERTY_ENUM_INFO;

メンバー

Header

NDIS_SWITCH_PROPERTY_ENUM_INFO構造体の型、リビジョン、サイズ。このメンバーは、 NDIS_OBJECT_HEADER 構造体として書式設定されます。

Header の Type メンバーは、NDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。 NDIS_SWITCH_PROPERTY_ENUM_INFO構造体のバージョンを指定するには、Header の Revision メンバーを次の値に設定する必要があります。

NDIS_SWITCH_PROPERTY_ENUM_INFO_REVISION_1

NDIS 6.30 以降の元のバージョン。

[サイズ] メンバーを [NDIS_SIZEOF_NDIS_SWITCH_PROPERTY_ENUM_PARAMETERS_REVISION_1] に設定します。

Flags

フラグのビットごとの OR を含む ULONG 値。このメンバーは NDIS 用に予約されています。

PropertyInstanceId

拡張可能スイッチプロパティのインスタンス識別子を指定するNDIS_SWITCH_OBJECT_INSTANCE_ID値。

PropertyVersion

拡張可能スイッチポートのプロパティのバージョンを識別するNDIS_SWITCH_OBJECT_VERSION値。

QwordAlignedPropertyBufferLength

プロパティバッファーのアラインサイズをバイト単位で指定する ULONG 値。

PropertyBufferLength

プロパティバッファーの実際のサイズをバイト単位で指定する ULONG 値。

メモこの値は 、QwordAlignedPropertyBufferLength メンバーの値以下である必要があります。

PropertyBufferOffset

NDIS_SWITCH_PROPERTY_ENUM_INFO構造体に続くプロパティバッファーへのオフセットをバイト単位で指定する ULONG 値。オフセットは、 NDIS_SWITCH_PROPERTY_PARAMETERS 構造体の先頭からプロパティバッファーの先頭まで測定されます。

注釈

NDIS_SWITCH_PROPERTY_ENUM_INFO構造体は、OID_SWITCH_PROPERTY_ENUMの OID セット要求で使用されます。 NDIS_SWITCH_PROPERTY_ENUM_INFO構造体の配列は、これらの OID セット要求に関連付けられている情報バッファー内のNDIS_SWITCH_PROPERTY_ENUM_PARAMETERS構造体に従います。 NDIS_OID_REQUEST構造体の InformationBuffer メンバーには、この情報バッファーへのポインターが含まれています。

拡張可能スイッチ拡張機能は 、NDIS_SWITCH_PROPERTY_ENUM_INFO_GET_NEXT マクロを使用して、配列内の NDIS_SWITCH_PROPERTY_ENUM_INFO 構造体に続く次の NDIS_SWITCH_PROPERTY_ENUM_INFO要素にアクセスできます。

拡張可能スイッチ拡張機能は、NDIS_SWITCH_PROPERTY_ENUM_INFO_GET_PROPERTY マクロを使用して、NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO 構造体で指定された拡張可能スイッチプロパティバッファーにアクセスできます。

拡張可能スイッチポリシーの詳細については、「 Hyper-V 拡張可能スイッチポリシー」を参照してください。