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 関数によって返されました。

戻り値

AdapterInstanceName の文字列のメモリが正常に割り当てられた場合、NdisQueryAdapterInstanceName はNDIS_STATUS_SUCCESSを返します。それ以外の場合は、NDIS_STATUS_RESOURCESを返します。

注釈

プロトコル ドライバーは 、NdisQueryAdapterInstanceName を使用して、プロトコル ドライバーがバインドされている物理 NIC または仮想アダプターのフレンドリ名を取得します。 プロトコル ドライバーは、 NdisBindingHandle でこのような NIC または仮想アダプターへのハンドルを指定します。 プロトコル ドライバーは、 NdisOpenAdapterEx 関数を呼び出して、このハンドルを取得します。

NdisQueryAdapterInstanceName は、フレンドリ名を指定する文字列にメモリを割り当てます。 呼び出し元がこのメモリの使用を終了した後、呼び出し元は NdisFreeMemory 関数を呼び出してメモリを解放する必要があります。

フレンドリ名は、ユーザーが物理 NIC または仮想アダプターを迅速かつ正確に識別できるように意図されています。たとえば、"PCI イーサネット アダプター" や "仮想プライベート ネットワーク アダプター" はフレンドリ名と見なされます。

要件

要件 値
サポートされている最小のクライアント Windows Vista の NDIS 6.0 ドライバーと NDIS 5.1 ドライバー (NdisQueryAdapterInstanceName (NDIS 5.1) を参照) でサポートされています。 Windows XP で NDIS 5.1 ドライバー (「NdisQueryAdapterInstanceName (NDIS 5.1)」を参照) でサポートされています。
対象プラットフォーム デスクトップ
Header ndis.h (Ndis.h を含む)
Library Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI コンプライアンス規則 Irql_Miscellaneous_Function(ndis)

こちらもご覧ください

NdisFreeMemory

NdisOpenAdapterEx

UNICODE_STRING