Funzione NdisMapFile (ndis.h)
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) |