Función WdfCommonBufferGetAlignedLogicalAddress (wdfcommonbuffer.h)

  • Artículo

[Solo se aplica a KMDF]

El método WdfCommonBufferGetAlignedLogicalAddress devuelve la dirección lógica asociada a un búfer común especificado.

Sintaxis

PHYSICAL_ADDRESS WdfCommonBufferGetAlignedLogicalAddress(
  [in] WDFCOMMONBUFFER CommonBuffer
);

Parámetros

[in] CommonBuffer

Identificador de un objeto de búfer común que el controlador obtuvo mediante una llamada anterior a WdfCommonBufferCreate.

Valor devuelto

WdfCommonBufferGetAlignedLogicalAddress devuelve la dirección lógica del búfer asociado al búfer común que especifica el parámetro CommonBuffer .

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Comentarios

Las direcciones lógicas son direcciones asignadas que los dispositivos usan para acceder a la memoria física.

Si el controlador llamado WdfDeviceSetAlignmentRequirement para establecer un requisito de alineación del búfer, el marco alinea el búfer común según ese requisito de alineación.

Para obtener más información sobre los búferes comunes, consulte Uso de búferes comunes.

Ejemplos

Para obtener un ejemplo de código que usa WdfCommonBufferGetAlignedLogicalAddress, vea WdfCommonBufferCreate.

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Encabezado wdfcommonbuffer.h (incluya WdfCommonBuffer.h)
Library Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
IRQL <= DISPATCH_LEVEL
Reglas de cumplimiento de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte también

WdfCommonBufferCreate

WdfCommonBufferGetAlignedVirtualAddress

WdfDeviceSetAlignmentRequirement