NdisMCmRegisterSapComplete マクロ (ndis.h)

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

NdisMCmRegisterSapComplete は、MCM ドライバーのクライアント要求の最終状態を返します。

ProtocolCmRegisterSap 関数は、SAP を登録するために以前にNDIS_STATUS_PENDINGを返しました。

構文

void NdisMCmRegisterSapComplete(
   _S_,
   _H_,
   _C_
);

パラメーター

_S_

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

_H_

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

_C_

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

戻り値

なし

解説

指定された NdisSapHandle で呼び出されたときに ProtocolCmRegisterSap 関数がNDIS_STATUS_PENDING返された場合、MCM ドライバーは NdisMCmRegisterSapComplete を呼び出す必要があります。 NdisMCmRegisterSapComplete を呼び出すと、NDIS はクライアントのを呼び出します。 ProtocolClRegisterSapComplete 関数。

MCM ドライバーが状態をNDIS_STATUS_SUCCESS以外に設定する場合は、NdisMCmRegisterSapComplete がコントロールを返すときに、NdisSapHandle が無効であると見なす必要があります。 SAP 登録に失敗した後、CM は既に割り当てられている SAP コンテキスト領域 (存在する場合) を解放または再利用できます。また、MCM ドライバーが登録に失敗した場合、NDIS は SAP のコンテキストも解放します。

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

要件

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