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 または仮想アダプターのいずれかであり、 ミニポート アダプターと呼ばれます。 ミニポート ドライバーは、ミニポート アダプターへのハンドルを ミニポートAdapterHandle で指定します。 このミニポート アダプターへのハンドルは、ミニポート ドライバーの MiniportInitializeEx 関数に渡され、ネットワーク I/O 操作用のミニポート アダプターを設定します。

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

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

要件

要件 値
サポートされている最小のクライアント NDIS 5.1 および NDIS 6.0 以降でサポートされています。 NDIS 5.1 ドライバーについては、「NdisMQueryAdapterInstanceName (NDIS 5.1)」を参照してください。
対象プラットフォーム ユニバーサル
Header ndis.h (Ndis.h を含む)
Library Ndis.lib
IRQL PASSIVE_LEVEL
DDI コンプライアンス規則 Irql_Miniport_Driver_Function(ndis)

こちらもご覧ください

MiniportInitializeEx

NdisFreeMemory

UNICODE_STRING