NdisCmRegisterAddressFamilyEx 関数 (ndis.h)

[アーティクル]
03/05/2024

NdisCmRegisterAddressFamilyEx 関数は、CoNDIS ドライバー間の通信用にアドレスファミリ (AF) を登録します。

構文

NDIS_STATUS NdisCmRegisterAddressFamilyEx(
  [in] NDIS_HANDLE        NdisBindingHandle,
  [in] PCO_ADDRESS_FAMILY AddressFamily
);

パラメーター

[in] NdisBindingHandle

NdisOpenAdapterEx 関数の NdisBindingHandle パラメーターで NDIS が指定したハンドル。このハンドルは、AF に関連付けるバインディングを識別します。

[in] AddressFamily

呼び出しマネージャーと、NdisBindingHandle が指定するバインディングでサポートされる AF を識別するCO_ADDRESS_FAMILY構造体へのポインター。

AddressFamily のポインターは、への入力パラメーターになります。同じ CoNDIS ミニポートアダプターにバインドされているすべてのクライアントの ProtocolCoAfRegisterNotify 関数。

戻り値

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

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

注釈

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

バインディングに AF を登録するには、スタンドアロン呼び出しマネージャーから NdisCmRegisterAddressFamilyEx を呼び出す必要があります。 ProtocolBindAdapterEx 関数。

スタンドアロン呼び出しマネージャーの ProtocolBindAdapterEx 関数は、まず NdisOpenAdapterEx 関数を呼び出して、基になるミニポートドライバーへのバインドを確立します。 NDIS が BindContext パラメーターで別のハンドルを使用して ProtocolBindAdapterEx を呼び出すたびに、ProtocolBindAdapterEx によってバインディングが確立され、サポートされている AF が登録されます。つまり、スタンドアロンコールマネージャは最終的に、接続指向クライアントにコール管理サービスを提供するバインディングごとにAFを登録します。

通話マネージャーは複数の AF をサポートでき、1 つのバインディングに対して複数の AF をサポートできます。ただし、特定のミニポートアダプターにバインドされているクライアントの特定の AF をサポートできる呼び出しマネージャーは 1 つだけです。

呼び出しマネージャーの ProtocolBindAdapterEx 関数がバインド操作の成功後にコントロールを返すと、NDIS はを呼び出します。同じミニポートアダプターにバインドされているすべてのクライアントの ProtocolCoAfRegisterNotify 関数。

要件

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