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

以前に入力されたミニポート アダプターへのハンドルミニポートInitializeEx 関数を します。

戻り値

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

備考

ミニポート ドライバー NdisMQueryAdapterInstanceName を使用して、ミニポート ドライバーが制御するインターフェイスのフレンドリ名を取得します。 このインターフェイスは、物理 NIC または仮想アダプターであり、ミニポート アダプターと呼ばれます。 ミニポート ドライバーは、ミニポート アダプターへのハンドル ミニポートAdapterHandle を指定します。 ミニポート アダプターへのこのハンドルは、ミニポート ドライバーの ミニポートInitializeEx ネットワーク 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)

関連項目

ミニポートInitializeEx

NdisFreeMemory の

UNICODE_STRING