NdisMCmRegisterAddressFamilyEx 関数 (ndis.h)

[アーティクル]
08/07/2023

NdisMCmRegisterAddressFamilyEx 関数は、ミニポート呼び出しマネージャー (MCM) と CoNDIS クライアント間の通信のためにアドレスファミリ (AF) を登録します。

構文

NDIS_STATUS NdisMCmRegisterAddressFamilyEx(
  [in] NDIS_HANDLE        MiniportAdapterHandle,
  [in] PCO_ADDRESS_FAMILY AddressFamily
);

パラメーター

[in] MiniportAdapterHandle

ミニポートアダプターを識別する NDIS 提供のハンドル。このハンドルは、MCM のへの入力パラメーターです。 MiniportInitializeEx 関数。

[in] AddressFamily

MCM ドライバーがサポートする AF を識別する CO_ADDRESS_FAMILY 構造体へのポインター。

ポインターは、への入力パラメーターになります。この MCM ドライバーにバインドされているすべての CoNDIS クライアントの ProtocolCoAfRegisterNotify 関数。

戻り値

NdisMCmRegisterAddressFamilyEx は、次のいずれかを返すことができます。

リターンコード	説明
NDIS_STATUS_SUCCESS	ADDRESSFamily パラメーターが指定した AF の呼び出しマネージャーとして NDIS に登録されているミニポートドライバー。そのため、NDIS はを呼び出します。MCM ドライバーにバインドするすべてのクライアントの ProtocolCoAfRegisterNotify 関数。
NDIS_STATUS_RESOURCES	NDIS が十分なメモリを割り当てられなかったか、指定した AF の呼び出しマネージャーとして MCM ドライバーを追跡するために使用する状態情報を初期化できなかったため、要求された操作が失敗しました。
NDIS_STATUS_FAILURE	NDIS は、次のいずれかの理由により、 NdisMCmRegisterAddressFamilyEx の呼び出しに失敗しました。呼び出し元が接続指向ミニポートドライバーとして登録されませんでした。呼び出し元は、特定のミニポートアダプターの重複する AF を登録しようとしました。

注釈

NDIS MCM。を呼び出して NDIS ミニポートドライバーとして登録します。 NdisMRegisterMiniportDriver 関数は、AF を登録するために NdisMCmRegisterAddressFamilyEx 関数を呼び出す必要があります。スタンドアロン通話マネージャーは、代わりにを呼び出す必要があります。 NdisCmRegisterAddressFamilyEx 関数。

ミニポートアダプターの AF を登録するには、MCM はミニポートInitializeEx 関数から NdisMCmRegisterAddressFamilyEx を呼び出す必要があります。

オンボード接続指向のシグナリングサポートを持つネットワークインターフェイスカード (NIC) のドライバーは、呼び出しの管理のパフォーマンスを向上させるために、それ自体を MCM ドライバーとして登録できます。ドライバーが MCM ドライバーとして登録されている場合、NIC ドライバー独自の呼び出し管理サポートを持つスタンドアロン通話マネージャーは移動されます。

MCM ドライバーは、NIC が完全に動作し、ドライバーがネットワーク I/O 操作を完了できると判断した後 、NdisMCmRegisterAddressFamilyEx を呼び出します。つまり、このような MCM はコールマネージャーとして自身を登録し、CoNDIS クライアント用に特定のシグナリングサービスをアドバタイズします。

MiniportInitializeEx が呼び出しマネージャーとして正常に登録されたコントロールを返した後、NDIS は潜在的なクライアントの ProtocolBindAdapterEx 関数を呼び出し、 ProtocolCoAfRegisterNotify 関連する MCM ミニポートアダプターに自分自身をバインドするすべてのクライアントの機能。これらのクライアントにより、NDIS は MCM の ProtocolCmOpenAf 関数を呼び出します。

MCM は、管理する 1 つの NIC に対して複数の AF をサポートできます。 MCM ドライバーは、ミニポートアダプターに登録する AF ごとに NdisMCmRegisterAddressFamilyEx を 1 回呼び出す必要があります。特定のミニポートアダプターにバインドされているクライアントの AF の特定の種類をサポートできる MCM ドライバーは 1 つだけです。

要件

要件	値
サポートされている最小のクライアント	NDIS 6.0 以降でサポートされています。
対象プラットフォーム	デスクトップ
Header	ndis.h (Ndis.h を含む)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	Irql_MCM_Function(ndis)