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
呼叫端提供的變數指標，在此變數中，此函式會傳回記錄檔的句柄。 此句柄是 miniport 驅動程式後續呼叫的 NdisXxxLog 函式的必要參數。
傳回值
NdisMCreateLog 可以傳回下列其中一項：
| 傳回碼 | 描述 |
|---|---|
|
迷你埠驅動程式可以使用 logHandle 傳回的句柄，將數據寫入 NDIS 配置的記錄檔。 |
|
無法設定指定大小的記錄檔。 |
|
驅動程式已呼叫 NdisMCreateLog 成功。 |
言論
迷你埠驅動程式可以呼叫 NdisM.。記錄 函式，以提供驅動程式寫入器選擇的任何資訊。 驅動程式專用 Win32 應用程式可以顯示任何迷你埠驅動程序記錄。 這類應用程式會定期呼叫 Win32 函式 DeviceIoControl IOCTL_NDIS_GET_LOG_DATA，並定期擷取任何迷你埠驅動程式已寫入記錄檔。 例如，開發不足的迷你埠驅動程式可能會撰寫測試數據，以供其對應的應用程式顯示。
如果 NdisMCreateLog 傳回NDIS_STATUS_RESOURCES，驅動程式可以向下調整原始 Size，然後再嘗試呼叫此函式。 不過，迷你埠驅動程序無法呼叫 NdisMCreateLog，在呼叫成功之後建立多個記錄檔。
無論配置記錄檔的大小為何，後續呼叫 NdisMWriteLogData 將此檔案中的數據儲存在此檔案中，這會被視為迴圈緩衝區。 也就是說，NdisMWriteLog Data 的一連串呼叫最終會覆寫原本寫入記錄檔的數據。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 支援 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） |