共用方式為

NdisIfQueryBindingIfIndex 函式 (ndis.h)

  • 發行項

NdisIfQueryBindingIfIndex 函式會擷取與指定通訊協議系結相關聯之最高和最低分層網路介面的網路介面索引和NET_LUID值。

語法

NDIS_STATUS NdisIfQueryBindingIfIndex(
  [in]  NDIS_HANDLE  NdisBindingHandle,
  [out] PNET_IFINDEX pBoundIfIndex,
  [out] PNET_LUID    pBoundIfNetLuid,
  [out] PNET_IFINDEX pLowestIfIndex,
  [out] PNET_LUID    pLowestIfNetLuid
);

參數

[in] NdisBindingHandle

句柄，識別 NDIS 應該取得 NET_LUID 值和網路介面索引的系結。 NDIS 在 NdisOpenAdapterEx 函式的 NdisBindingHandle 參數上提供此句柄。

[out] pBoundIfIndex

呼叫端提供的介面索引變數指標。 如果 NdisIfQueryBindingIfIndex 成功，NDIS 會寫入此變數與指定系結相關聯的網路介面索引，而且在驅動程式堆疊中最高。

[out] pBoundIfNetLuid

呼叫端提供的NET_LUID變數指標。 如果 NdisIfQueryBindingIfIndex 成功，NDIS 會寫入此變數中與指定系結相關聯的網路介面NET_LUID值，而且驅動程式堆疊中最高。

[out] pLowestIfIndex

呼叫端提供的介面索引變數指標。 如果 NdisIfQueryBindingIfIndex 成功，NDIS 會將與指定系結相關聯的網路介面的網路介面索引寫入此變數，而且驅動程式堆棧中最低。

[out] pLowestIfNetLuid

呼叫端提供的NET_LUID變數指標。 如果 NdisIfQueryBindingIfIndex 成功，NDIS 會寫入此變數中與指定系結相關聯的網路介面NET_LUID值，而且在驅動程式堆棧中是最低的。

傳回值

NdisIfQueryBindingIfIndex 會傳回下列其中一個狀態值：

傳回碼 Description
NDIS_STATUS_SUCCESS
 作業已成功完成。
NDIS_STATUS_INTERFACE_NOT_FOUND
 NdisIfQueryBindingIfIndex 失敗，因為指定的系結未與已註冊的介面相關聯。

備註

NDIS 通訊協定驅動程式可以呼叫 NdisIfQueryBindingIfIndex 函式來擷取與系結相關聯的網路介面索引和 NET_LUID 值。

NdisIfQueryBindingIfIndex 提供與系結相關聯之最高介面和最低介面的NET_LUID值和介面索引。 例如，如果直接與指定系結相關聯的迷你埠配接器是篩選中繼驅動程式的虛擬迷你埠，或有透過迷你埠配接器設定的篩選模組，這些值會有所不同。

通訊協定驅動程式也可以取得NDIS_BIND_PARAMETERS結構中驅動程式堆疊中最高和最低介面的介面索引和 NET_LUID 。

規格需求

需求 值
最低支援的用戶端 NDIS 6.0 和更新版本支援。
目標平台 桌面
標頭 ndis.h (包含 Ndis.h)
程式庫 Ndis.lib
IRQL PASSIVE_LEVEL
DDI 合規性規則 Irql_Interfaces_Function (ndis)

另請參閱

NDIS_BIND_PARAMETERS

NET_LUID

NdisOpenAdapterEx