Función NdisMapFile (ndis.h)

Artículo
02/26/2024

La función NdisMapFile asigna un archivo ya abierto a un búfer accesible para el autor de la llamada si el archivo no está asignado actualmente.

Sintaxis

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

Parámetros

[out] Status

Puntero a una variable proporcionada por el autor de la llamada en la que esta función devuelve el estado de la operación de asignación, que puede ser una de las siguientes:

NDIS_STATUS_SUCCESS

El autor de la llamada tiene acceso exclusivo al contenido del archivo hasta que se llama a la función NdisUnmapFile .

NDIS_STATUS_ALREADY_MAPPED

El autor de la llamada no puede acceder al contenido del archivo en este momento.

[out] MappedBuffer

Puntero a una variable proporcionada por el autor de la llamada en la que esta función devuelve la dirección virtual base del contenido del archivo asignado o NULL.

[in] FileHandle

Identificador devuelto por una llamada anterior a la función NdisOpenFile .

Valor devuelto

None

Observaciones

NdisMapFile asocia (asigna) un intervalo de direcciones virtuales con un archivo abierto para que el controlador pueda acceder al contenido del archivo. NdisMapFile solo permite que una asignación de un archivo determinado esté pendiente en cualquier momento. Por lo tanto, se concede acceso exclusivo a un llamador correcto a los datos del archivo hasta que se llama a NdisUnmapFile o a la función NdisCloseFile .

Un controlador de minipuerto puede asignar y desasignación de este tipo de archivo abierto según sea necesario, mediante llamadas alternas a NdisMapFile y NdisUnmapFile. Una llamada a NdisCloseFile libera FileHandle y desasigna el búfer que contiene el contenido del archivo.

Un controlador de minipuerto solo puede llamar a NdisMapFile durante la inicialización.

Requisitos

Requisito	Value
Cliente mínimo compatible	Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulte NdisMapFile (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisMapFile (NDIS 5.1)) en Windows XP.
Plataforma de destino	Universal
Encabezado	ndis.h (incluya Video.h)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Reglas de cumplimiento de DDI	Irql_Miscellaneous_Function(ndis)