Macro NdisAdjustMdlLength (ndis.h)

  • Artículo

La función NdisAdjustMdlLength modifica la longitud de los datos asociados a un MDL.

Sintaxis

void NdisAdjustMdlLength(
  [in]  _Mdl,
  [in]  _Length
);

Parámetros

[in] _Mdl

Puntero a una lista de descriptores de memoria (MDL).

[in] _Length

Número de bytes de datos que describe MDL.

Valor devuelto

None

Observaciones

La función NdisAdjustMdlLength modifica el miembro ByteCount de una MDL asignada mediante una llamada a la función NdisAllocateMdl .

El autor de la llamada de NdisAdjustMdlLength solo puede pasar un descriptor MDL que el autor de la llamada asignó. No puede pasar un descriptor MDL asignado a otro controlador.

Por ejemplo, el controlador de una NIC DMA de maestro de bus llama a NdisAdjustMdlLength con descriptores MDL asignados para especificar mdl de recepción en su bloque de memoria compartida. Antes de que dicho controlador indique los datos recibidos, llama a NdisAdjustMdlLength para que el descriptor MDL que incluya en la indicación de recepción coincida con el tamaño de los datos recibidos si es menor que el tamaño del búfer de recepción de la NIC.

La longitud que se pasa a NdisAdjustMdlLength no puede ser mayor que la longitud que se pasó a NdisAllocateMdl cuando se asignó el descriptor MDL.

El autor de la llamada de NdisAdjustMdlLength debe restaurar la longitud a su valor original antes de liberar el descriptor MDL con NdisFreeMdl.

Los autores de llamadas de NdisAdjustMdlLength se pueden ejecutar en cualquier IRQL, pero normalmente se ejecutan en IRQL <= DISPATCH_LEVEL.

Requisitos

Requisito Value
Cliente mínimo compatible Se admite en NDIS 6.0 y versiones posteriores.
Plataforma de destino Escritorio
Encabezado ndis.h (incluya Ndis.h)
IRQL Cualquier nivel (consulte la sección Comentarios)

Consulte también

NdisAllocateMdl

NdisFreeMdl