Función StorPortAllocateMdl (storport.h)

La rutina StorPortAllocateMdl asigna una MDL para describir la memoria de grupo no paginada especificada.

Sintaxis

ULONG StorPortAllocateMdl(
  [in]  PVOID HwDeviceExtension,
  [in]  PVOID BufferPointer,
  [in]  ULONG NumberOfBytes,
  [out] PVOID *Mdl
);

Parámetros

[in] HwDeviceExtension

Puntero a la extensión de dispositivo de hardware para el adaptador de bus host (HBA).

[in] BufferPointer

Puntero a la dirección virtual base del búfer que el MDL va a describir.

[in] NumberOfBytes

Este parámetro especifica la longitud, en bytes, del búfer que se va a describir en MDL.

[out] Mdl

Puntero para recibir la MDL asignada.

Valor devuelto

StorPortAllocateMdl devuelve uno de los siguientes códigos de estado:

Código devuelto	Descripción
STOR_STATUS_NOT_IMPLEMENTED	Esta función no se implementa en el sistema operativo activo.
STOR_STATUS_SUCCESS	Indica que la rutina asignó correctamente la MDL.
STOR_STATUS_INVALID_PARAMETER	El puntero para recibir el MDL es NULL. El puntero al búfer es NULL.
STOR_STATUS_INVALID_IRQL	La llamada se realizó en un IRQL no válido.
STOR_STATUS_INSUFFICIENT_RESOURCES	No se puede asignar MDL para describir el búfer especificado.

Observaciones

Un controlador de miniporta llama a la rutina StorPortAllocateMdl para asignar una MDL para describir un bloque de memoria del grupo no paginado. Para liberar la MDL, el controlador de miniporta llama a la rutina StorPortFreeMdl.

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
encabezado de	storport.h (incluya Storport.h)
irQL	<=DISPATCH_LEVEL
reglas de cumplimiento de DDI	storPortIrql(storport)