NdisFRestartComplete 関数 (ndis.h)
フィルター ドライバーは、ドライバーが FilterRestart 関数からNDIS_STATUS_PENDINGを返した場合に再起動操作を完了するには、NdisFRestartComplete 関数を呼び出す必要があります。
構文
void NdisFRestartComplete(
[in] NDIS_HANDLE NdisFilterHandle,
[in] NDIS_STATUS Status
);
パラメーター
[in] NdisFilterHandle
このフィルター モジュールを識別する NDIS ハンドル。 NDIS は FilterAttach 関数の呼び出しでフィルター ドライバーにハンドルを渡しました。
[in] Status
再起動操作の最終的な状態。 次の状態値がサポートされています。
NDIS_STATUS_SUCCESS
ドライバーは、ネットワーク データのフローを正常に再起動しました。
NDIS_STATUS_RESOURCES
リソースが不足しているため、再起動に失敗しました。
NDIS_STATUS_FAILURE
ドライバーは、上記の値が適用されない場合にNDIS_STATUS_FAILUREを示します。 ドライバーは、エラーの理由を指定するパラメーターと共に NdisWriteEventLogEntry 関数を呼び出す必要があります。
戻り値
なし
解説
NDIS は、フィルター ドライバーの FilterRestart 関数を呼び出して、フィルター モジュールの再起動要求を開始します。 フィルター モジュールは、再起動操作が完了するまで 再起動 状態のままです。
ドライバーが NdisFRestartComplete 関数を呼び出した後、保留中の再起動操作が完了します。 フィルター モジュールは、再起動操作が完了した後、 実行中 の状態になります。
フィルター ドライバーは、NDIS が FilterRestart を呼び出した直後、およびドライバーが NdisFRestartComplete を呼び出す前に、受信したネットワーク データを示す再開できます。 ドライバーは、再起動操作が完了した後、送信要求を受け入れる準備ができている必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | NDIS 6.0 以降でサポートされています。 |
| 対象プラットフォーム | デスクトップ |
| Header | ndis.h (Ndis.h を含む) |
| Library | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| DDI コンプライアンス規則 | Irql_Filter_Driver_Function(ndis) |