Rutinas de compatibilidad del controlador de puerto ATA

  • Artículo

En esta página se clasifican las rutinas de soporte proporcionadas por el controlador de puerto ATA proporcionado por el sistema.

Para obtener una lista de rutinas de minipuerto de controladores de ATA, consulta Controladores de minipuerto de ATA.

Rutina de inicialización

El controlador de puerto de ATA proporciona la siguiente rutina de inicialización.

Rutina Descripción
AtaPortInitializeEx Inicializa los controladores de puerto y minipuerto.

Rutinas para el acceso al espacio de configuración PCI

El controlador de puerto ATA proporciona las siguientes rutinas para ayudarle a leer y modificar el contenido del espacio de configuración PCI del dispositivo.

Rutina Descripción
AtaPortGetBusData Recupera datos de la ubicación especificada dentro del espacio de configuración pci del dispositivo.
AtaPortSetBusData almacena los datos en el espacio de configuración PCI del dispositivo indicado en el desplazamiento especificado.

Rutinas para procesar solicitudes de E/S

El controlador de puerto de ATA proporciona las siguientes rutinas de soporte técnico de procesamiento de solicitudes de E/S.

Rutina Descripción
AtaPortGetScatterGatherList Recupera la lista de dispersión y recopilación asociada a esta solicitud.
AtaPortGetPhysicalAddress Convierte el intervalo de direcciones virtuales en el intervalo de direcciones físico.
AtaPortGetDeviceBase Devuelve una dirección base lógica asignada que se usa para comunicarse con un adaptador de bus host (HBA).
AtaPortGetUncachedExtension Asigna un búfer común sin almacenar en caché compartido por la CPU y el dispositivo.
AtaPortBuildRequestSenseIrb Compila y devuelve un IRB para el código de operación SCSIOP_REQUEST_SENSE.
AtaPortReleaseRequestSenseIrb Libera el IRB de sentido de solicitud asignado mediante AtaPortBuildRequestSenseIrb.
AtaPortCompleteAllActiveRequests Completa todos los IRB activos para el dispositivo indicado.
AtaPortCompleteRequest Completa el IRB indicado.

Rutinas de devolución de llamada

El controlador de minipuerto usa varias rutinas para solicitar una devolución de llamada del controlador de puerto.

Rutina Descripción
AtaPortRequestWorkerRoutine Solicita una rutina de trabajo.
AtaPortRequestSynchronizedRoutine Solicita la sincronización con la rutina del servicio de interrupción (ISR).
AtaPortControllerSyncRoutine Proporciona acceso sincronizado a estructuras de datos que se comparten entre todos los canales de un controlador.
AtaPortRequestTimer Solicita una devolución de llamada del temporizador.

Rutinas que notifican un cambio de configuración

Las rutinas siguientes permiten al controlador de minipuerto notificar al controlador de puerto ATA los cambios en la configuración de los dispositivos conectados al canal.

Rutina Descripción
AtaPortBusChangeDetected Notifica al controlador de puerto los cambios en la configuración del dispositivo en el canal indicado.
AtaPortRequestPowerStateChange Solicita una transición de estado de energía para el dispositivo indicado.

Rutinas para controlar las colas de solicitudes

El controlador de puerto mantiene una cola de solicitudes por número de unidad lógica (LUN) y una cola de solicitudes para cada canal. El controlador de minipuerto puede usar las siguientes rutinas para pausar y reanudar las diferentes colas de solicitudes.

Rutina Descripción
AtaPortDeviceBusy Informa al controlador de puerto de que el dispositivo indicado está ocupado.
AtaPortDeviceReady Informa al controlador de puerto de que el dispositivo indicado está listo para aceptar nuevas solicitudes.

Rutinas de utilidad

Las siguientes rutinas son funciones de compatibilidad de utilidad general para controladores de miniporte.

Rutina Descripción
AtaPortCopyMemory Copia datos de una ubicación a otra.
**Rutina AtaPortMoveMemory Copia datos de una ubicación a otra.
AtaPortConvertUlongToPhysicalAddress Convierte una dirección ULONG determinada en un valor de tipo IDE_PHYSICAL_ADDRESS.
AtaPortConvertPhysicalAddressToUlong Trunca una dirección de tipo IDE_PHYSICAL_ADDRESS en una ULONG.
AtaPortStallExecution Se detiene en el miniportador.
AtaPortInitializeQueueTag Inicializa la lista de etiquetas de cola para el dispositivo especificado.
AtaPortAllocateQueueTag Devuelve una etiqueta de cola para el dispositivo especificado.
AtaPortReleaseQueueTag Libera la etiqueta de cola especificada.

Rutinas de informes de errores y depuración

La rutina siguiente se puede usar para la depuración y los informes de errores.

Rutina Descripción
AtaPortDebugPrint Pasa una cadena de mensaje al depurador de kernel para que el depurador se imprima.

Rutinas para el puerto de dispositivo y registrar el acceso

El controlador de puerto de ATA proporciona los siguientes puertos y registra las rutinas de compatibilidad de acceso.

Rutina Descripción
AtaPortReadPortBufferUchar Transfiere un número determinado de valores de bytes sin signo del HBA a un búfer.
AtaPortReadPortBufferUlong Transfiere un número determinado de valores de ULONG del HBA a un búfer.
AtaPortReadPortBufferUshort Transfiere un número determinado de valores de USHORT del HBA a un búfer.
AtaPortReadPortUchar Lee un valor de byte sin signo del HBA.
AtaPortReadPortUlong Lee un valor de ULONG del HBA.
AtaPortReadPortUshort Lee un valor de USHORT del HBA.
AtaPortReadRegisterBufferUchar Transfiere un número especificado de bytes sin signo del HBA a un búfer.
AtaPortReadRegisterBufferUlong Transfiere un número especificado de ULONG desde el HBA a un búfer.
AtaPortReadRegisterBufferUshort Transfiere un número especificado de USHORT del HBA a un búfer.
AtaPortReadRegisterUchar Lee un valor de byte sin signo del HBA.
AtaPortReadRegisterUlong Lee un valor de ULONG del HBA.
AtaPortReadRegisterUshort Lee un valor de USHORT del HBA.
AtaPortWritePortBufferUchar Escribe un valor en una dirección de registro especificada.
AtaPortWritePortBufferUlong Escribe un valor en una dirección de registro especificada.
AtaPortWritePortBufferUshort Escribe un valor en una dirección de registro especificada.
AtaPortWritePortUchar Transfiere un valor de byte sin signo al HBA.
AtaPortWritePortUlong Transfiere un valor ULONG al HBA.
AtaPortWritePortUshort Transfiere un valor de USHORT al HBA.
AtaPortWriteRegisterBufferUchar Transfiere el número especificado de bytes sin signo de un búfer al HBA.
AtaPortWriteRegisterBufferUlong Transfiere el número especificado de valores de ULONG de un búfer al HBA.
AtaPortWriteRegisterBufferUshort Transfiere el número especificado de valores de USHORT de un búfer al HBA.
AtaPortWriteRegisterUchar Transfiere un byte sin signo a la dirección HBA.
AtaPortWriteRegisterUlong Transfiere un valor ULONG a la dirección HBA.
AtaPortWriteRegisterUshort Transfiere un valor de USHORT a la dirección HBA.

Rutinas para el acceso al Registro

Un controlador de minipuerto que implementa la interfaz de canal puede llamar a las siguientes rutinas para acceder al Registro de Windows. Los controladores de miniporte que solo implementan las rutinas de interfaz del controlador no pueden acceder a estas rutinas.

Rutina Descripción
AtaPortRegistryAllocateBuffer Asigna un búfer para las operaciones del Registro.
AtaPortRegistryFreeBuffer Libera el búfer del Registro que se asignó mediante AtaPortRegistryAllocateBuffer.
AtaPortRegistryControllerKeyRead Lee los datos asociados al nombre de valor indicado en la clave del Registro HKLM\CurrentControlSet\Services\<service name>\ControllerN, donde N es el número del controlador.
AtaPortRegistryContrlollerKeyWrite Escribe los datos en el nombre de valor indicado en la clave del Registro HKLM\CurrentControlSet\Services\<service name>\ControllerN, donde N es el número del controlador.
AtaPortRegistryControllerKeyWriteDeferred Escribe los datos de forma asincrónica en el nombre de valor indicado en la clave del Registro HKLM\CurrentControlSet\Services\<service name>\ControllerN, donde N es el número del controlador.
AtaPortRegistryChannelSubKeyRead Lee los datos asociados al nombre de valor indicado en la clave del Registro HKLM\CurrentControlSet\Services\<service name>\ControllerN\ChannelM, donde N es el número del controlador y M es el número del canal.
AtaPortRegistryChannelSubKeyWrite Escribe los datos en el nombre de valor indicado en la clave del Registro HKLM\CurrentControlSet\Services\<service name>\ControllerN\ChannelM, donde N es el número del controlador y M es el número del canal.
AtaPortRegistryChannelSubKeyWriteDeferred Escribe los datos de forma asincrónica en el nombre de valor indicado en la clave del Registro HKLM\CurrentControlSet\Services\<service name>\ControllerN\ChannelM, donde N es el número del controlador y M es el número del canal.