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 関数。
戻り値
pAdapterInstanceName の文字列のメモリが正常に割り当てられた場合、 NdisQueryBindInstanceName は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) を参照) でサポートされています。 |
| 対象プラットフォーム | デスクトップ |
| Header | ndis.h (Ndis.h を含む) |
| Library | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI コンプライアンス規則 | NdisQueryBindInstanceName(ndis) |