NdisCmRegisterSapComplete 関数 (ndis.h)

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

NdisCmRegisterSapComplete は、以前に CM が SAP を登録するためにNDIS_STATUS_PENDING返したクライアントの要求の最終的な状態を返します。

構文

void NdisCmRegisterSapComplete(
  [in] NDIS_STATUS Status,
  [in] NDIS_HANDLE NdisSapHandle,
  [in] NDIS_HANDLE CallMgrSapContext
);

パラメーター

[in] Status

SAP を登録するクライアントの元の要求の最終的な状態を指定します(NDIS_STATUS_SUCCESS、または CM によって決定されたNDIS_STATUS_XXX (NDIS_STATUS_PENDINGを除く)。

[in] NdisSapHandle

登録が成功した場合に、SAP への NDIS 提供のハンドルを指定します。呼び出しマネージャーは、このハンドルを、への入力パラメーターとして取得しました。 ProtocolCmRegisterSap 関数。

[in] CallMgrSapContext

登録が成功した場合に CM がこの SAP の状態を維持する、呼び出し元が指定した常駐コンテキスト領域へのハンドルを指定します。その場合、NDIS は、この SAP に関する後続のすべての呼び出しで、このハンドルを CM に戻します。 Status がNDIS_STATUS_SUCCESS以外の値に設定されている場合、NDIS はこのパラメーターを無視します。

戻り値

なし

解説

スタンドアロン呼び出しマネージャーは、指定された NdisSapHandle で呼び出されたときに ProtocolCmRegisterSap 関数がNDIS_STATUS_PENDING返された場合に NdisCmRegisterSapComplete を呼び出す必要があります。 NdisCmRegisterSapComplete を呼び出すと、NDIS はクライアントのを呼び出します。 ProtocolClRegisterSapComplete 関数。

呼び出しマネージャーが状態をNDIS_STATUS_SUCCESS以外に設定する場合は、NdisCmRegisterSapComplete を呼び出すとすぐに NdisSapHandle が無効であると見なす必要があります。 SAP 登録に失敗した後、 CM は NdisCmRegisterSapComplete が制御を返すときに割り当てた SAP ごとのコンテキスト領域を解放または再利用できます。また、呼び出しマネージャーが登録に失敗した場合、NDIS は SAP のコンテキストも解放します。

スタンドアロンの呼び出しマネージャー (プロトコルドライバーとして NDIS に自身を登録する) のみが NdisCmRegisterSapComplete を呼び出すことができます。統合された呼び出し管理サポートを提供する接続指向のミニポートドライバーは、 NdisMCmRegisterSapComplete を呼び出します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista の NDIS 6.0 および NDIS 5.1 ドライバー (「NdisCmRegisterSapComplete (NDIS 5.1)」を参照) でサポートされています。 Windows XP での NDIS 5.1 ドライバー (「NdisCmRegisterSapComplete (NDIS 5.1)」を参照) でサポートされています。
対象プラットフォーム	デスクトップ
Header	ndis.h (Ndis.h を含む)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI コンプライアンス規則	Irql_CallManager_Function(ndis)