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 可以傳回下列其中一項：

傳回碼 Description
NDIS_STATUS_SUCCESS
 迷你埠驅動程式可以使用 LogHandle 傳回的句柄，將數據寫入 NDIS 配置的記錄檔。
NDIS_STATUS_RESOURCES
 無法設定指定大小的記錄檔。
NDIS_STATUS_FAILURE
 驅動程式已經成功呼叫 NdisMCreateLog 。

備註

迷你埠驅動程式可以呼叫 NdisM。記錄 函式，以提供驅動程式寫入器選擇的任何資訊。 任何迷你埠驅動程序記錄都可以由驅動程式專用 Win32 應用程式顯示。 這類應用程式會定期呼叫 Win32 函式 DeviceIoControl ，並定期IOCTL_NDIS_GET_LOG_DATA擷取迷你埠驅動程式已寫入記錄檔的任何專案。 例如，開發不足的迷你埠驅動程式可能會撰寫測試數據，以供其對應的應用程式顯示。

如果 NdisMCreateLog 傳回NDIS_STATUS_RESOURCES，驅動程式可以向下調整原始 大小 ，然後再試一次呼叫此函式。 不過，迷你埠驅動程序無法呼叫 NdisMCreateLog ，在呼叫成功之後建立多個記錄檔。

配置任何記錄檔大小，後續呼叫 NdisMWriteLogData 會將數據儲存在此檔案中，這會被視為迴圈緩衝區。 也就是說， 對 NdisMWriteLogData 的一連串呼叫最終會覆寫原本寫入記錄檔的數據。

規格需求

需求 值
最低支援的用戶端 支援 NDIS 6.0 和 NDIS 5.1 驅動程式， (請參閱 Windows Vista 中的 NdisMCreateLog (NDIS 5.1) ) 。 支援 NDIS 5.1 驅動程式 (請參閱 Windows XP 中的 NdisMCreateLog (NDIS 5.1) ) 。
目標平台 Universal
標頭 ndis.h (包含 Ndis.h)
程式庫 Ndis.lib
IRQL PASSIVE_LEVEL
DDI 合規性規則 Irql_Miniport_Driver_Function (ndis)

另請參閱

MiniportInitializeEx

NdisMCloseLog

NdisMFlushLog

NdisMWriteLogData