共用方式為

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 會傳回下列其中一個狀態值：

傳回碼 描述
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