Función NdisMapFile (ndis.h)
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
Ninguno
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, a un autor de llamada correcto se le concede acceso exclusivo a los datos del archivo hasta que se llama a NdisUnmapFile o a la función NdisCloseFile.
Un controlador de miniport 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 el FileHandle y desasigna el búfer que contiene el contenido del archivo.
Un controlador de miniport puede llamar a NdisMapFile solo durante la inicialización.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | 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. |
| de la plataforma de destino de | Universal |
| encabezado de | ndis.h (incluya Video.h) |
| biblioteca de | Ndis.lib |
| irQL | <= DISPATCH_LEVEL |
| reglas de cumplimiento de DDI | Irql_Miscellaneous_Function(ndis) |