共用方式為

NdisQueryBindInstanceName 函式 (ndis.h)

  • 發行項

NdisQueryBindInstanceName 函式會擷取實體 NIC 或呼叫通訊協定驅動程式將系結的虛擬配接器易記名稱。

語法

NDIS_STATUS NdisQueryBindInstanceName(
  [out] PNDIS_STRING pAdapterInstanceName,
  [in]  NDIS_HANDLE  BindingContext
);

參數

[out] pAdapterInstanceName

呼叫端提供的NDIS_STRING型別指標，可接收已計算的 Unicode 字串。 此字串會指定系結所參考之介面的易記名稱。 此介面是實體 NIC 或虛擬配接器。 針對 Microsoft Windows 2000 和更新版本的作業系統，NDIS 會將NDIS_STRING類型定義為 UNICODE_STRING 類型。

[in] BindingContext

識別系結作業之 NDIS 內容區域的句柄。 NDIS 將此句柄傳遞至的 BindContext 參數 ProtocolBindAdapterEx 函 式。

傳回值

如果成功配置 pAdapterInstanceName 之字串的記憶體，NdisQueryBindInstanceName 會傳回NDIS_STATUS_SUCCESS;否則會傳回NDIS_STATUS_RESOURCES。

備註

通訊協定驅動程式會使用 NdisQueryBindInstanceName 來擷取實體 NIC 的易記名稱，或將系結通訊協定驅動程式的虛擬適配卡。 通訊協定驅動程式會指定 NDIS 在 中提供的系結內容 ProtocolBindAdapterEx 函 式。

通訊協議驅動程式可以使用 NdisQueryBindInstanceName 取得易記名稱，再系結至配接器。

NdisQueryBindInstanceName 會為指定易記名稱的字串配置記憶體。 呼叫端使用此記憶體完成之後，呼叫端必須呼叫 NdisFreeMemory 函式以釋放記憶體。

易記名稱旨在協助使用者快速且精確地識別實體 NIC 或虛擬適配卡，例如，「PCI 乙太網路卡」和「虛擬專用網卡」會被視為易記名稱。

規格需求

需求 值
最低支援的用戶端 支援 NDIS 6.0 和 NDIS 5.1 驅動程式， (請參閱 Windows Vista 中的 NdisQueryBindInstanceName (NDIS 5.1) ) 。 (支援 NDIS 5.1 驅動程式，請參閱 Windows XP 中的 NdisQueryBindInstanceName (NDIS 5.1) ) 。
目標平台 桌面
標頭 ndis.h (包含 Ndis.h)
程式庫 Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI 合規性規則 NdisQueryBindInstanceName (ndis)

另請參閱

NdisFreeMemory

ProtocolBindAdapterEx

UNICODE_STRING