Функция NdisMapFile (ndis.h)

Статья
08/07/2023

Функция NdisMapFile сопоставляет уже открытый файл с буфером, доступным вызывающей стороны, если файл в настоящее время не сопоставлен.

Синтаксис

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

Параметры

[out] Status

Указатель на переменную, предоставленную вызывающей стороны, в которой эта функция возвращает состояние операции сопоставления, которое может быть одним из следующих:

NDIS_STATUS_SUCCESS

Вызывающий объект имеет монопольный доступ к содержимому файла, пока не будет вызвана функция NdisUnmapFile .

NDIS_STATUS_ALREADY_MAPPED

В настоящее время вызывающий объект не может получить доступ к содержимому файла.

[out] MappedBuffer

Указатель на переменную, предоставленную вызывающей стороны, в которой эта функция возвращает базовый виртуальный адрес содержимого сопоставленного файла или значение NULL.

[in] FileHandle

Дескриптор, возвращенный предыдущим вызовом функции NdisOpenFile .

Возвращаемое значение

None

Remarks

NdisMapFile связывает (сопоставляет) диапазон виртуальных адресов с открытым файлом, чтобы драйвер смог получить доступ к содержимому файла. NdisMapFile позволяет в любой момент только одно сопоставление определенного файла быть неоплаченным. Следовательно, успешный вызывающий объект получает монопольный доступ к данным файла, пока не будет вызван NdisUnmapFile или функция NdisCloseFile .

Драйвер мини-порта может сопоставлять и отменять сопоставление такого открытого файла при необходимости, используя чередующиеся вызовы NdisMapFile и NdisUnmapFile. Вызов NdisCloseFile освобождает FileHandle и освобождает буфер, содержащий содержимое файла.

Драйвер минипорта может вызывать NdisMapFile только во время инициализации.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается для драйверов NDIS 6.0 и NDIS 5.1 (см. раздел NdisMapFile (NDIS 5.1)) в Windows Vista. Поддерживается для драйверов NDIS 5.1 (см. NdisMapFile (NDIS 5.1)) в Windows XP.
Целевая платформа	Универсальное
Верхняя часть	ndis.h (включая Video.h)
Библиотека	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Правила соответствия DDI	Irql_Miscellaneous_Function(ndis)