NdisMQueryAdapterInstanceName 函式 （ndis.h）
NdisMQueryAdapterInstanceName 函式會擷取迷你埠適配卡的易記名稱。
語法
NDIS_STATUS NdisMQueryAdapterInstanceName(
PNDIS_STRING pAdapterInstanceName,
NDIS_HANDLE MiniportHandle
);
參數
pAdapterInstanceName
接收已計算 Unicode 字串之呼叫端所提供之NDIS_STRING類型的指標。 此字串會指定指定指定指定迷你埠配接器的介面易記名稱。 針對 Windows Vista 和更新版本的 Windows作系統，NDIS 會將NDIS_STRING類型定義為 UNICODE_STRING 類型。
MiniportHandle
先前輸入至的迷你埠配接器的句柄 MiniportInitializeEx 函式。
傳回值
如果已成功配置 adapterInstanceName 的字串記憶體，則傳回 NDIS_STATUS_SUCCESS;否則，它會傳回NDIS_STATUS_RESOURCES。
言論
迷你埠驅動程式會使用 NdisMQueryAdapterInstanceName 來擷取迷你埠驅動程式所控制之介面的易記名稱。 此介面是實體 NIC 或虛擬配接器，稱為 迷你連接埠配接器。 迷你埠驅動程式會在 MiniportAdapterHandle 中指定迷你埠適配卡的句柄。 此迷你埠適配卡的句柄會傳遞至迷你埠驅動程式的 MiniportInitializeEx 函式，以設定用於網路 I/O 作業的迷你埠配接器。
NdisMQueryAdapterInstanceName 為指定易記名稱的字串配置記憶體。 呼叫端使用此記憶體完成之後，呼叫端必須呼叫 NdisFreeMemory 函式來釋放記憶體。
易記名稱旨在協助使用者快速且準確地識別實體 NIC 或虛擬適配卡，例如，「PCI 乙太網路卡」和「虛擬專用網路適配器」會被視為易記名稱。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | NDIS 5.1 和 NDIS 6.0 和更新版本支援。 如需 NDIS 5.1 驅動程式，請參閱 NdisMQueryAdapterInstanceName （NDIS 5.1）。 |
| 目標平臺 | 普遍 |
| 標頭 | ndis.h （包括 Ndis.h） |
| 連結庫 | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| DDI 合規性規則 | Irql_Miniport_Driver_Function（ndis） |