NdisQueryAdapterInstanceName 函式 (ndis.h)

NdisQueryAdapterInstanceName 函式會擷取呼叫通訊協定驅動程式所繫結之實體 NIC 或虛擬適配卡的易記名稱。

語法

NDIS_STATUS NdisQueryAdapterInstanceName(
       PNDIS_STRING pAdapterInstanceName,
  [in] NDIS_HANDLE  NdisBindingHandle
);

參數

pAdapterInstanceName

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

[in] NdisBindingHandle

句柄，識別呼叫端所系結之下一個較低驅動程式的目標實體 NIC 或虛擬配接器。 一般而言， NdisBindingHandle 是由 NdisOpenAdapterEx 函式傳回。

傳回值

NdisQueryAdapterInstanceName 如果已成功配置 AdapterInstanceName 的字串記憶體，則會傳回NDIS_STATUS_SUCCESS;否則，它會傳回NDIS_STATUS_RESOURCES。

備註

通訊協定驅動程式會使用 NdisQueryAdapterInstanceName 來擷取通訊協定驅動程式所系結之實體 NIC 或虛擬適配卡的易記名稱。 通訊協定驅動程式會指定 NdisBindingHandle 中這類 NIC 或虛擬配接器的句柄。 通訊協議驅動程式會呼叫 NdisOpenAdapterEx 函式來擷取此句柄。

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

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

規格需求

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

另請參閱

NdisFreeMemory

NdisOpenAdapterEx

UNICODE_STRING