次の方法で共有

NdisMCreateLog 関数 (ndis.h)

  • [アーティクル]

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

構文

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

パラメーター

[in] MiniportAdapterHandle

ミニポートInitializeEx をするハンドル入力を指定します。

[in] Size

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

[out] LogHandle

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

戻り値

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

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

備考

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

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) を参照) でサポートされています。
ターゲット プラットフォーム の 万国
ヘッダー ndis.h (Ndis.h を含む)
ライブラリ Ndis.lib
IRQL PASSIVE_LEVEL
DDI コンプライアンス規則 を する Irql_Miniport_Driver_Function(ndis)

関連項目

ミニポートInitializeEx

NdisMCloseLog の

NdisMFlushLog の

NdisMWriteLogData の