NdisMCreateLog-Funktion (ndis.h)

Artikel
02/07/2025

NdisMCreateLog eine Protokolldatei zuordnet und öffnet sie, in der ein Miniporttreiber Daten schreiben kann, die von einer treiberspezifischen Win32-Anwendung angezeigt werden.

Syntax

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

Parameter

[in] MiniportAdapterHandle

Gibt die Handleeingabe für MiniportInitializeEx-an.

[in] Size

Gibt an, wie viele Bytes für die Protokolldatei zugewiesen werden sollen. NDIS erstellt eine temporäre Datei, die nicht auf dem Datenträger gespeichert ist.

[out] LogHandle

Zeiger auf eine vom Aufrufer bereitgestellte Variable, in der diese Funktion ein Handle für die Protokolldatei zurückgibt. Dieses Handle ist ein erforderlicher Parameter für die NdisXxxLog Funktionen, die der Miniporttreiber anschließend aufruft.

Rückgabewert

NdisMCreateLog- kann eine der folgenden Werte zurückgeben:

Rückgabecode	Beschreibung
NDIS_STATUS_SUCCESS	Der Miniporttreiber kann das bei LogHandle- zurückgegebene Handle verwenden, um Daten in die von NDIS zugewiesene Protokolldatei zu schreiben.
NDIS_STATUS_RESOURCES	Eine Protokolldatei der angegebenen Größe konnte nicht zugeordnet werden.
NDIS_STATUS_FAILURE	Der Treiber hat bereits NdisMCreateLog erfolgreich aufgerufen.

Bemerkungen

Ein Miniporttreiber kann die NdisM aufrufen. Protokollieren Sie Funktionen, um informationen bereitzustellen, die der Treiberschreiber auswäht. Unabhängig davon, welche Miniport-Treiberprotokolle von einer treiberspezifischen Win32-Anwendung angezeigt werden können. Eine solche Anwendung ruft die Win32-Funktion DeviceIoControl mit IOCTL_NDIS_GET_LOG_DATA regelmäßig auf, um den Miniporttreiber in die Protokolldatei abzurufen. Beispielsweise kann ein Miniporttreiber für die Unterentwicklung Testdaten schreiben, die von der entsprechenden Anwendung angezeigt werden.

Wenn NdisMCreateLog NDIS_STATUS_RESOURCES zurückgibt, kann der Treiber die ursprüngliche Größe nach unten anpassen und versuchen, diese Funktion erneut aufzurufen. Ein Miniporttreiber kann jedoch nicht NdisMCreateLog- aufrufen, um mehrere Protokolldateien zu erstellen, nachdem ein Aufruf erfolgreich war.

Unabhängig von der Größe der Protokolldatei werden nachfolgende Aufrufe an NdisMWriteLogData Speichern von Daten in dieser Datei, die als Zirkelpuffer behandelt wird. Das heißt, eine Abfolge von Aufrufen an NdisMWriteLogData schließlich überschreibt die ursprünglich in die Protokolldatei geschriebenen Daten.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisMCreateLog (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisMCreateLog (NDIS 5.1)) in Windows XP.
Zielplattform-	Universal
Header-	ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL-	PASSIVE_LEVEL
DDI-Complianceregeln	Irql_Miniport_Driver_Function(ndis)

Siehe auch

MiniportInitializeEx-

NdisMCloseLog

NdisMFlushLog

NdisMWriteLogData-

Freigeben über