NdisMCreateLog 関数 (ndis.h)

  • [アーティクル]

NdisMCreateLog は、ミニポート ドライバーがドライバー専用 Win32 アプリケーションによって表示されるデータを書き込むことができるログ ファイルを割り当てて開きます。

構文

NDIS_STATUS NdisMCreateLog(
  [in]  NDIS_HANDLE  MiniportAdapterHandle,
  [in]  UINT         Size,
  [out] PNDIS_HANDLE LogHandle
);

パラメーター

[in] MiniportAdapterHandle

MiniportInitializeEx へのハンドル入力を指定します。

[in] Size

ログ ファイルに割り当てるバイト数を指定します。 NDIS は、ディスクに格納されていない一時ファイルを作成します。

[out] LogHandle

この関数がログ ファイルへのハンドルを返す、呼び出し元から指定された変数へのポインター。 このハンドルは、ミニポート ドライバーが後で呼び出す NdisXxxログ 関数に必要なパラメーターです。

戻り値

NdisMCreateLog は、次のいずれかを返すことができます。

リターン コード 説明
NDIS_STATUS_SUCCESS
 ミニポート ドライバーは、NDIS 割り当てログ ファイルにデータを書き込む には、LogHandle で返されるハンドルを使用できます。
NDIS_STATUS_RESOURCES
 指定したサイズのログ ファイルを割り当てませんでした。
NDIS_STATUS_FAILURE
 ドライバーは既に NdisMCreateLog を正常に呼び出しました。

注釈

ミニポート ドライバーは NdisM を呼び出すことができます 。. ドライバー ライターが選択した情報を提供する関数をログに記録します。 ミニポート ドライバー ログは、ドライバー専用 Win32 アプリケーションによって表示できます。 このようなアプリケーションは、Win32 関数 DeviceIoControl をIOCTL_NDIS_GET_LOG_DATA定期的に呼び出して、ミニポート ドライバーがログ ファイルに書き込むものを取得します。 たとえば、開発中のミニポート ドライバーは、対応するアプリケーションによって表示されるテスト データを書き込む場合があります。

NdisMCreateLog がNDIS_STATUS_RESOURCESを返す場合、ドライバーは元のサイズを調整して、この関数をもう一度呼び出してみてください。 ただし、ミニポート ドライバーは、呼び出しが成功した後、複数のログ ファイルを作成する NdisMCreateLog を呼び出すことはできません。

どのサイズのログ ファイルが割り当てられている場合でも、 NdisMWriteLogData の後続の呼び出しでは、循環バッファーとして扱われるこのファイルにデータが格納されます。 つまり、 NdisMWriteLogData の一連の呼び出しによって、ログ ファイルに最初に書き込まれたデータが最終的に上書きされます。

要件

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

こちらもご覧ください

MiniportInitializeEx

NdisMCloseLog

NdisMFlushLog

NdisMWriteLogData