Funzione NdisMapFile (ndis.h)

Articolo
08/07/2023

La funzione NdisMapFile esegue il mapping di un file già aperto in un buffer accessibile dal chiamante se il file è attualmente non eseguito il mapping.

Sintassi

void NdisMapFile(
  [out] PNDIS_STATUS Status,
  [out] PVOID        *MappedBuffer,
  [in]  NDIS_HANDLE  FileHandle
);

Parametri

[out] Status

Puntatore a una variabile fornita dal chiamante in cui questa funzione restituisce lo stato dell'operazione di mapping, che può essere una delle seguenti:

NDIS_STATUS_SUCCESS

Il chiamante ha accesso esclusivo al contenuto del file finché non viene chiamata la funzione NdisUnmapFile .

NDIS_STATUS_ALREADY_MAPPED

Il chiamante non può accedere al contenuto del file in questo momento.

[out] MappedBuffer

Puntatore a una variabile fornita dal chiamante in cui questa funzione restituisce l'indirizzo virtuale di base del contenuto del file mappato o NULL.

[in] FileHandle

Handle restituito da una chiamata precedente alla funzione NdisOpenFile .

Valore restituito

nessuno

Osservazioni

NdisMapFile associa (mappe) un intervallo di indirizzi virtuale a un file aperto in modo che il driver possa accedere al contenuto del file. NdisMapFile consente l'esecuzione di un solo mapping di un determinato file in qualsiasi momento. Di conseguenza, un chiamante con esito positivo viene concesso l'accesso esclusivo ai dati del file fino a NdisUnmapFile o alla funzione NdisCloseFile .

Un driver miniport può eseguire il mapping e rimuovere il mapping di un file aperto in base alle esigenze, usando chiamate alternate a NdisMapFile e NdisUnmapFile. Una chiamata a NdisCloseFile rilascia il fileHandle e dealloca il buffer contenente il contenuto del file.

Un driver miniport può chiamare solo NdisMapFile durante l'inizializzazione.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisMapFile (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisMapFile (NDIS 5.1) in Windows XP.
Piattaforma di destinazione	Universale
Intestazione	ndis.h (includere Video.h)
Libreria	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	Irql_Miscellaneous_Function(ndis)