NdisQueryBindInstanceName 函式 （ndis.h）
NdisQueryBindInstanceName 函式會擷取實體 NIC 或呼叫通訊協定驅動程式所系結之虛擬適配卡的易記名稱。
語法
NDIS_STATUS NdisQueryBindInstanceName(
[out] PNDIS_STRING pAdapterInstanceName,
[in] NDIS_HANDLE BindingContext
);
參數
[out] pAdapterInstanceName
接收已計算 Unicode 字串之呼叫端所提供之NDIS_STRING類型的指標。 此字串會指定系結所參考之介面的易記名稱。 此介面是實體 NIC 或虛擬配接器。 對於 Microsoft Windows 2000 和更新版本的作系統，NDIS 會將NDIS_STRING類型定義為 UNICODE_STRING 類型。
[in] BindingContext
識別系結作業之 NDIS 內容區域的句柄。 NDIS 將此句柄傳遞至 的 BindContext 參數 ProtocolBindAdapterEx 函式。
傳回值
NdisQueryBindInstanceName 傳回NDIS_STATUS_SUCCESS，如果已成功配置 pAdapterInstanceName 的字元串記憶體;否則，它會傳回NDIS_STATUS_RESOURCES。
言論
通訊協定驅動程式會使用 NdisQueryBindInstanceName 來擷取實體 NIC 或通訊協定驅動程式所系結之虛擬適配卡的易記名稱。 通訊協定驅動程式會指定 NDIS 在 中提供的系結內容 ProtocolBindAdapterEx 函式。
通訊協議驅動程式可以使用 NdisQueryBindInstanceName，在系結至配接器之前取得易記名稱。
NdisQueryBindInstanceName 為指定易記名稱的字串配置記憶體。 呼叫端使用此記憶體完成之後，呼叫端必須呼叫 NdisFreeMemory 函式來釋放記憶體。
易記名稱旨在協助使用者快速且準確地識別實體 NIC 或虛擬適配卡，例如，「PCI 乙太網路卡」和「虛擬專用網路適配器」會被視為易記名稱。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 支援 Windows Vista 中的 NDIS 6.0 和 NDIS 5.1 驅動程式（請參閱 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） |