PROTOCOL_CO_AF_REGISTER_NOTIFY コールバック関数 (ndis.h)
ProtocolCoAfRegisterNotify 関数は、接続指向 NDIS クライアントで使用されます。 すべての接続指向 NDIS クライアントには、完全に機能する ProtocolCoAfRegisterNotify 関数が必要です。 スタンドアロン接続指向の呼び出しマネージャーには、単に制御を返す ProtocolCoAfRegisterNotify 関数が登録されています。
構文
PROTOCOL_CO_AF_REGISTER_NOTIFY ProtocolCoAfRegisterNotify;
VOID() ProtocolCoAfRegisterNotify(
[in] NDIS_HANDLE ProtocolBindingContext,
[in] PCO_ADDRESS_FAMILY AddressFamily
)
{...}
パラメーター
[in] ProtocolBindingContext
クライアント プロトコルがバインドごとの実行時状態を維持するクライアント割り当てコンテキスト領域へのハンドルを指定します。 クライアントの ProtocolBindAdapterEx 関数は、 NdisOpenAdapterEx を呼び出したときにこのハンドルを提供しました。
[in] AddressFamily
呼び出しによってこれらのサービスを NDIS に登録した呼び出しマネージャーによって提供されるシグナリング プロトコルのサポートを記述するバッファーへのポインター NdisCmRegisterAddressFamilyEx または NdisMCmRegisterAddressFamilyEx。
戻り値
なし
解説
ProtocolCoAfRegisterNotify の呼び出しは、クライアントがバインドされている基になる接続指向 NIC で、特定の呼び出しマネージャーまたは MCM ドライバーの呼び出し管理サービスをアドバタイズします。
ProtocolCoAfRegisterNotify は AddressFamily のデータを調べて、クライアントがこの特定の呼び出しマネージャーのサービスを使用できるかどうかを判断します。 クライアントが AddressFamily で (M)CM 提供のデータを変更できるかどうかは、呼び出しマネージャーの特定のシグナリング プロトコルのサポートに依存します。
クライアントが提供されている呼び出し管理サービスを受け入れられないと検出した場合、ProtocolCoAfRegisterNotify は制御を返し、NDIS は同じ ProtocolBindingContext ハンドルと、この呼び出しマネージャーまたは別の呼び出しマネージャーによって提供される AF 仕様も同じ基になるミニポート ドライバーにバインドして ProtocolCoAfRegisterNotify を再度呼び出す可能性があります。 それ以外の場合、ProtocolAfRegisterNotify はクライアントに AF ごとのコンテキスト領域を割り当て、AddressFamily ポインターを使用して NdisClOpenAddressFamilyEx を呼び出します。 この呼び出しが成功した場合、クライアントは、この呼び出しマネージャーのサービスを使用して、後続の接続指向操作用に ProtocolClXxx 関数を NDIS に登録します。
たとえば、 ProtocolCoAfRegisterNotify または ProtocolClOpenAfCompleteEx は、 NdisInitializeNPagedLookaside クライアントが後で必要とする SAP、VC ごと、および/またはパーティごとのコンテキスト領域の動的割り当てとリリースに備えて、1 回以上リストします。
着信呼び出しを受け入れる場合は、クライアントの ProtocolCoAfRegisterNotify または ProtocolClOpenAfCompleteEx 関数は、通常、1 つ以上の SAP を呼び出しマネージャーに登録します。 その呼び出しマネージャーの AF を開いた後、クライアントは SAP ごとの状態領域の割り当てに進み、NdisClOpenAddressFamilyEx から取得した NdisAfHandle を使用して NdisClRegisterSap を 1 回以上呼び出す可能性があります。 発信呼び出しを行う場合、クライアントは割り当てられた VC ごとの状態領域に進み、リモート ノードへの発信呼び出しを行うために、独自のクライアントからの着信要求を想定して NdisCoCreateVc を使用して VC を作成する可能性があります。
例
ProtocolCoAfRegisterNotify 関数を定義するには、まず、定義する関数の種類を識別する関数宣言を指定する必要があります。 Windows には、ドライバーの関数型のセットが用意されています。 関数の種類を使用して関数を宣言すると、 ドライバーのコード分析、 静的ドライバー検証ツール (SDV)、およびその他の検証ツールでエラーが検出され、Windows オペレーティング システム用のドライバーを記述するための要件になります。たとえば、" MyCoAfRegisterNotify" という名前の ProtocolCoAfRegisterNotify 関数を定義するには、次のコード例に示すように 、PROTOCOL_CO_AF_REGISTER_NOTIFY 型を使用します。
PROTOCOL_CO_AF_REGISTER_NOTIFY MyCoAfRegisterNotify;
次に、次のように関数を実装します。
_Use_decl_annotations_
VOID
MyCoAfRegisterNotify(
NDIS_HANDLE ProtocolBindingContext,
PCO_ADDRESS_FAMILY AddressFamily
)
{...}
PROTOCOL_CO_AF_REGISTER_NOTIFY関数の種類は、Ndis.h ヘッダー ファイルで定義されています。 コード分析ツールを実行するときにエラーをより正確に識別するには、 Use_decl_annotations 注釈を関数定義に追加してください。 Use_decl_annotations注釈を使用すると、ヘッダー ファイル内のPROTOCOL_CO_AF_REGISTER_NOTIFY関数型に適用される注釈が確実に使用されます。 関数宣言の要件の詳細については、「NDIS ドライバーの関数 ロール型を使用して関数を宣言する」を参照してください。
Use_decl_annotationsの詳細については、「関数の動作に注釈を付ける」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (「ProtocolCoAfRegisterNotify (NDIS 5.1)」を参照) でサポートされています。 Windows XP の NDIS 5.1 ドライバー (「ProtocolCoAfRegisterNotify (NDIS 5.1)」を参照) でサポートされています。 |
対象プラットフォーム | Windows |
ヘッダー | ndis.h (Ndis.h を含む) |
IRQL | PASSIVE_LEVEL |