NdisCmRegisterAddressFamilyEx 関数 (ndis.h)
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 は、次のいずれかを返すことができます。
リターン コード | 説明 |
---|---|
|
プロトコル ドライバーは AddressFamily が指す AF を登録したので、NDIS は を呼び出します。 ProtocolCoAfRegisterNotify 同じミニポート アダプターに自分自身をバインドするすべてのクライアントの関数。 |
|
NDIS が十分なメモリを割り当てられなかったか、呼び出しマネージャーまたは指定された AF を追跡するために使用する状態を初期化できなかったため、要求された操作が失敗しました。 |
|
NDIS は、次のいずれかの理由により、 NdisCmRegisterAddressFamilyEx の呼び出しに失敗しました。
|
注釈
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) |