NdisFRestartComplete 関数 (ndis.h)

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

フィルタードライバーは、ドライバーが 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)