Función StorPortAllocateMdl (storport.h)

La rutina StorPortAllocateMdl asigna una MDL para describir la memoria del 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 se 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 la 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.

Comentarios

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

Requisitos

Requisito	Value
Plataforma de destino	Universal
Encabezado	storport.h (incluya Storport.h)
IRQL	<=DISPATCH_LEVEL
Reglas de cumplimiento de DDI	StorPortIrql(storport)