NdisCmRegisterSapComplete 関数 (ndis.h)
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 によって決定された XXX NDIS_STATUS_ NDIS_STATUS_PENDINGを除く)。
[in] NdisSapHandle
登録が成功した場合に、SAP に対する NDIS 提供のハンドルを指定します。 呼び出しマネージャーは、そのハンドルへの入力パラメーターとしてこのハンドルを取得しました。ProtocolCmRegisterSap 関数を します。
[in] CallMgrSapContext
登録が成功した場合に CM がこの SAP の状態を維持する呼び出し元指定の常駐コンテキスト領域へのハンドルを指定します。 その場合、NDIS は、この SAP に関する後続のすべての呼び出しで CM にこのハンドルを渡します。 状態 が 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) を参照) でサポートされています。 |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | ndis.h (Ndis.h を含む) |
| ライブラリ | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| DDI コンプライアンス規則 を する | Irql_CallManager_Function(ndis) |
関連項目
NdisAllocateFromNPagedLookasideList のNdisMCmRegisterSapComplete の
ProtocolClRegisterSapComplete