Función StorPortGetUncachedExtension (storport.h)

La rutina StorPortGetUncachedExtension asigna un búfer común sin almacenamiento en caché que compartirá la CPU y el dispositivo.

Sintaxis

STORPORT_API PVOID StorPortGetUncachedExtension(
  PVOID                           HwDeviceExtension,
  PPORT_CONFIGURATION_INFORMATION ConfigInfo,
  ULONG                           NumberOfBytes
);

Parámetros

HwDeviceExtension

Puntero a la extensión de dispositivo de hardware. Se trata de un área de almacenamiento por HBA que el controlador de puerto asigna e inicializa en nombre del controlador de minipuerto. Los controladores de minipuerto suelen almacenar información específica de HBA en esta extensión, como el estado del HBA y los intervalos de acceso asignados para el HBA. Esta área está disponible para el controlador de minipuerto inmediatamente después de que el controlador de minipuerto llame a StorPortInitialize. El controlador de puerto libera esta memoria cuando quita el dispositivo.

ConfigInfo

Especifica información sobre las funcionalidades DMA de HBA. Los miembros siguientes deben rellenarse: DmaChannel o DmaPort, DmaWidth, DmaSpeed, MaximumTransferLength, ScatterGather, Master establecido en TRUE, NumberOfPhysicalBreaks, AdapterInterfaceType, Dma32BitAddresses, Dma64BitAddresses, SystemIoBusNumber, AutoRequestSense y SrbExtensionSize.

Los miembros que no son pertinentes para el HBA, como DmaChannel para un adaptador EISA bus-master, deben dejarse tal como está.

NumberOfBytes

Tamaño necesario, en bytes, de la extensión sin almacenar en caché que se va a asignar.

Valor devuelto

StorPortGetUncachedExtension devuelve un puntero de dirección virtual a la extensión sin almacenamiento en caché. Si no puede asignar la memoria solicitada, devuelve NULL. Si la memoria se asignó anteriormente, se devuelve el puntero de dirección virtual a la extensión no almacenada en caché actual.

Comentarios

Los dispositivos maestros de bus usan espacio de búfer común para las transferencias DMA.

Requisitos

Consulte también

ScsiPortGetUncachedExtension