Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This function maps an already open file into a caller-accessible buffer if the file is currently unmapped.
VOID NdisMapFile(PNDIS_STATUSStatus,PVOID* MappedBuffer,NDIS_HANDLEFileHandle);
Parameters
- Status
[out] Points to a caller-supplied variable in which this function returns the status of the mapping operation, which can be one of the following:NDIS_STATUS_SUCCESS
The caller has exclusive access to the file contents until NdisUnmapFile is called.
NDIS_STATUS_ALREADY_MAPPED
The caller cannot access the file contents at this time.
- MappedBuffer
[out] Points to a caller-supplied variable in which this function returns the base virtual address of the mapped file contents or NULL. - FileHandle
[in] Specifies the handle returned by a preceding call to NdisOpenFile.
Return Values
None.
Remarks
NdisMapFile associates or maps a virtual address range with an opened file so the driver can access the file contents. NdisMapFile allows only one mapping of a particular file to be outstanding at any time. Consequently, a successful caller is given exclusive access to the file data until NdisUnmapFile or NdisCloseFile is called.
A NIC driver can map and unmap such an open file as necessary, using alternating calls to NdisMapFile and NdisUnmapFile. A call to NdisCloseFile releases the FileHandle and de-allocates the buffer containing the file contents.
A NIC driver can call NdisMapFile only during initialization.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Ndis.h.
Link Library: Ndis.dll.
See Also
NdisCloseFile | NdisOpenFile | NdisUnmapFile
Send Feedback on this topic to the authors