NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX結構（ndis.h）

發行項
02/07/2025

NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX 結構會定義與 NET_BUFFER_LIST 結構相關聯的媒體特定資訊。

語法

typedef struct _NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX {
  NDIS_OBJECT_HEADER                             Header;
  struct _NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX *NextEntry;
  ULONG                                          Tag;
  PVOID                                          Data;
} NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX, *PNDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX;

成員

Header

結構的 NDIS_OBJECT_HEADER 結構（NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX）。驅動程式會將 Header 指定為 NDIS_OBJECT_TYPE_DEFAULT 的 Type 成員、將 Revision 成員設定為 NDIS_NBL_MEDIA_SPECIFIC_INFO_REVISION_1，並將 Size 成員設定為 NDIS_SIZEOF_NBL_MEDIA_SPECIFIC_INFO_REVISION_1。

NextEntry

NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX結構連結清單中的下一個NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX結構的指標。如果這是清單中的最後一個結構，指標會 NULL。驅動程式必須使用 NDIS_NBL_ADD_MEDIA_SPECIFIC_INFO_EX、 NDIS_NBL_GET_MEDIA_SPECIFIC_INFO_EX、和 NDIS_NBL_REMOVE_MEDIA_SPECIFIC_INFO_EX 巨集來作此清單。

Tag

識別媒體特定資訊類型的唯一值（由Microsoft指派）。此成員保留供系統使用。

針對需要特定媒體類型特定其他 OOB 數據的新媒體類型，未來系統版本可以指派新的標籤。

Data

包含媒體特定信息的緩衝區指標。

言論

NDIS 6.20 和更新版本的驅動程序應該使用 NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX 結構來指定媒體特定資訊。 NDIS 驅動程式堆疊中的任何驅動程式都可以配置和管理媒體特定資訊。媒體特定資訊會以 NULL 終止的連結清單來指定NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX結構，而每個結構都包含驅動程式配置的和驅動程式定義的數據。

清單中的結構包含與 NET_BUFFER_LIST 結構相關聯之 NET_BUFFER 結構的任何媒體特定頻外（OOB）數據。

如果通訊協定驅動程式配置 OOB 數據，則會設定傳送作業的數據。如果迷你埠驅動程式已配置數據，則會設定接收指示的數據。

若要取得連結清單中的第一個專案，NDIS 驅動程式會呼叫 NET_BUFFER_LIST_INFO 巨集，並指定 MediaSpecificInformationEx 資訊類型。

若要在連結清單中新增、取得和移除NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX結構，請使用 NDIS_NBL_ADD_MEDIA_SPECIFIC_INFO_EX、 NDIS_NBL_GET_MEDIA_SPECIFIC_INFO_EX、和 NDIS_NBL_REMOVE_MEDIA_SPECIFIC_INFO_EX 巨集。