Funzione NdisMCreateLog (ndis.h)

Articolo
02/29/2024

NdisMCreateLog alloca e apre un file di log in cui un driver miniport può scrivere dati da visualizzare da un'applicazione Win32 dedicata al driver.

Sintassi

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

Parametri

[in] MiniportAdapterHandle

Specifica l'input dell'handle per MiniportInitializeEx.

[in] Size

Specifica il numero di byte da allocare per il file di log. NDIS crea un file temporaneo non archiviato su disco.

[out] LogHandle

Puntatore a una variabile fornita dal chiamante in cui questa funzione restituisce un handle al file di log. Questo handle è un parametro obbligatorio per le funzioni NdisXxxLog chiamate successivamente dal driver miniport.

Valore restituito

NdisMCreateLog può restituire uno dei seguenti elementi:

Codice restituito	Descrizione
NDIS_STATUS_SUCCESS	Il driver miniport può usare l'handle restituito in LogHandle per scrivere dati nel file di log allocato da NDIS.
NDIS_STATUS_RESOURCES	Impossibile allocare un file di log delle dimensioni specificate.
NDIS_STATUS_FAILURE	Il driver già chiamato NdisMCreateLog correttamente.

Commenti

Un driver miniport può chiamare NdisM.. Funzioni di log per fornire informazioni scelte dal writer driver. Indipendentemente dai log dei driver miniport possono essere visualizzati da un'applicazione Win32 dedicata al driver. Tale applicazione chiama periodicamente la funzione Win32 DeviceIoControl con IOCTL_NDIS_GET_LOG_DATA per recuperare qualsiasi driver miniport scritto nel file di log. Ad esempio, un driver miniport in fase di sviluppo potrebbe scrivere dati di test da visualizzare dall'applicazione corrispondente.

Se NdisMCreateLog restituisce NDIS_STATUS_RESOURCES, il driver può modificare le dimensioni originali e provare a chiamare nuovamente questa funzione. Tuttavia, un driver miniport non può chiamare NdisMCreateLog per creare più file di log dopo che una chiamata ha esito positivo.

Indipendentemente dalle dimensioni del file di log, le chiamate successive a NdisMWriteLogData archiviano i dati in questo file, che vengono considerati come buffer circolare. Ovvero, una sequenza di chiamate a NdisMWriteLogData sovrascrive i dati originariamente scritti nel file di log.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisMCreateLog (NDIS 5.1)) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisMCreateLog (NDIS 5.1)) in Windows XP.
Piattaforma di destinazione	Universale
Intestazione	ndis.h (include Ndis.h)
Libreria	Ndis.lib
IRQL	PASSIVE_LEVEL
Regole di conformità DDI	Irql_Miniport_Driver_Function(ndis)

Vedi anche

Condividi tramite