NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX 結構 (ndis.h)

發行項
02/29/2024

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_NBL_MEDIA_SPECIFIC_INFORMATION_EX) 的NDIS_OBJECT_HEADER 結構。驅動程式會設定 Header 指定要NDIS_OBJECT_TYPE_DEFAULT的 Type 成員、要NDIS_NBL_MEDIA_SPECIFIC_INFO_REVISION_1的 Revision 成員，以及要NDIS_SIZEOF_NBL_MEDIA_SPECIFIC_INFO_REVISION_1的 Size 成員。

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 驅動程式堆疊中的任何驅動程式都可以配置和管理媒體特定資訊。媒體特定資訊是在NDIS_NBL_MEDIA_SPECIFIC_INFORMATION_EX結構的NULL終止連結清單中指定，而每個結構都包含驅動程式配置和驅動程式定義的數據。

清單中的結構包含與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 宏。