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) |