PCMCIA_MODIFY_MEMORY_WINDOW función de devolución de llamada (ntddpcm.h)
La rutina de interfaz PCMCIA_MODIFY_MEMORY_WINDOW establece los atributos de una ventana de memoria para una tarjeta de memoria PCMCIA. El controlador de bus PCMCIA asigna la ventana de memoria.
Sintaxis
PCMCIA_MODIFY_MEMORY_WINDOW PcmciaModifyMemoryWindow;
BOOLEAN PcmciaModifyMemoryWindow(
[in, optional] PVOID Context,
[in] ULONGLONG HostBase,
[in] ULONGLONG CardBase,
[in] BOOLEAN Enable,
[in, optional] ULONG WindowSize,
[in, optional] UCHAR AccessSpeed,
[in, optional] UCHAR BusWidth,
[in, optional] BOOLEAN IsAttributeMemory
)
{...}
Parámetros
[in, optional] Context
Puntero al contexto de la rutina de interfaz.
[in] HostBase
Especifica la ventana de memoria física que se va a asignar. HostBase es la dirección base de la tarjeta de memoria del espacio de direcciones físicos del sistema.
[in] CardBase
Especifica el desplazamiento de bytes en la memoria de la tarjeta pc o tarjeta CardBus donde comienza la asignación de memoria.
[in] Enable
Especifica el permiso para acceder a la ventana de memoria. Si Habilitar es TRUE, se permite el acceso a memoria; de lo contrario, no se permite el acceso a memoria.
[in, optional] WindowSize
Especifica el tamaño, en bytes, de la ventana de memoria asignada. El valor de WindowSize no puede superar la ventana de memoria concedida al controlador en sus recursos asignados. Si el valor de Enable es TRUE y el valor de WindowSize es cero, se usa el tamaño de la ventana de memoria concedida al controlador en sus recursos asignados. Si Enable es FALSE, No se usa WindowSize .
[in, optional] AccessSpeed
Especifica la velocidad de acceso de la tarjeta PC o tarjeta CardBus. El valor de AccessSpeed se codifica según lo especificado por el Estándar de tarjeta PC, Versión 6.1. Si Enable es FALSE, AccessSpeed no se usa.
[in, optional] BusWidth
Especifica el ancho del acceso de bus a la tarjeta de memoria PCMCIA. BusWidth debe ser uno de los siguientes valores:
- PCMCIA_MEMORY_8BIT_ACCESS: si Enable es FALSE, no se usa BusWidth .
- PCMCIA_MEMORY_16BIT_ACCESS
[in, optional] IsAttributeMemory
Debe ser FALSE para la memoria común y TRUE para la memoria de atributo.
Valor devuelto
La rutina de interfaz PCMCIA_MODIFY_MEMORY_WINDOW devuelve TRUE si la ventana de memoria está habilitada o deshabilitada correctamente, según lo especificado por el parámetro Enable .
Comentarios
Un llamador debe establecer el parámetro Context en el contexto especificado por el controlador de bus PCMCIA. El controlador de bus PCMCIA devuelve el contexto de las rutinas de interfaz en el miembro Context de la misma estructura PCMCIA_INTERFACE_STANDARD que contiene los punteros a las rutinas de interfaz. Si el parámetro Context no es válido, no se define el comportamiento del sistema y el sistema podría detenerse.
Los autores de llamadas de esta rutina deben ejecutarse en IRQL <= DISPATCH_LEVEL. Para mantener el rendimiento general del sistema, se recomienda que los controladores llamen a esta rutina en IRQL < DISPATCH_LEVEL.
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Escritorio |
Encabezado | ntddpcm.h (incluya Ntddpcm.h) |
IRQL | <=DISPATCH_LEVEL (vea la sección Comentarios). |