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 は、pAdapterInstanceName の文字列のメモリが正常に割り当てられた場合にNDIS_STATUS_SUCCESSを返します。それ以外の場合は、NDIS_STATUS_RESOURCESを返します。
備考
プロトコル ドライバーは、NdisQueryBindInstanceName を使用して、プロトコル ドライバーがバインドされる物理 NIC または仮想アダプターのフレンドリ名を取得します。 プロトコル ドライバーは、NDIS で提供されるバインディング コンテキストを指定します。ProtocolBindAdapterEx 関数を します。
プロトコル ドライバーは、NdisQueryBindInstanceName 使用して、アダプターにバインドする前にフレンドリ名を取得できます。
NdisQueryBindInstanceName 、フレンドリ名を指定する文字列のメモリを割り当てます。 呼び出し元がこのメモリの使用を完了した後、呼び出し元は、メモリを解放する NdisFreeMemory 関数を呼び出す必要があります。
フレンドリ名は、物理 NIC または仮想アダプター ("PCI イーサネット アダプター" や "仮想プライベート ネットワーク アダプター" など) をユーザーが迅速かつ正確に識別できるように設計されています。フレンドリ名と見なされます。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (NdisQueryBindInstanceName (NDIS 5.1) を参照) でサポートされています。 Windows XP で NDIS 5.1 ドライバー (NdisQueryBindInstanceName (NDIS 5.1) を参照) でサポートされています。 |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | ndis.h (Ndis.h を含む) |
| ライブラリ | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI コンプライアンス規則 を する | NdisQueryBindInstanceName(ndis) の |
関連項目
NdisFreeMemory の