Función StorPortAllocateRegistryBuffer (storport.h)

El controlador de minipuerto llama a la rutina StorPortAllocateRegistryBuffer para asignar un búfer que se puede usar para leer y escribir datos del Registro.

Sintaxis

STORPORT_API PUCHAR StorPortAllocateRegistryBuffer(
  [in] PVOID  HwDeviceExtension,
  [in] PULONG Length
);

Parámetros

[in] 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. El controlador de minipuerto debe ejecutarse en IRQL PASSIVE_LEVEL cuando llama a esta rutina.

[in] Length

Puntero a un long que indica, en la entrada, la longitud en bytes del búfer del Registro que requiere el autor de la llamada. En la salida, length se actualiza para reflejar el tamaño real en bytes del búfer asignado.

Valor devuelto

StorPortAllocateRegistryBuffer devuelve un puntero al búfer del Registro que solicitó el autor de la llamada o NULL si algún error impide que se asigne la memoria.

Comentarios

Cada instancia de un controlador de minipuerto solo puede tener asignado un búfer del Registro a la vez. Si un controlador de minipuerto intenta asignar más de un búfer del Registro, se producirá un error en la asignación y StorPortAllocateRegistryBuffer devolverá NULL.

Requisitos

Consulte también

StorPortFreeRegistryBuffer