Función WdfCommonBufferGetAlignedVirtualAddress (wdfcommonbuffer.h)

[Solo se aplica a KMDF]

El método WdfCommonBufferGetAlignedVirtualAddress devuelve la dirección virtual asociada a un búfer común especificado.

Sintaxis

PVOID WdfCommonBufferGetAlignedVirtualAddress(
  [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

WdfCommonBufferGetAlignedVirtualAddress devuelve la dirección virtual 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

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 WdfCommonBufferGetAlignedVirtualAddress, 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

WdfCommonBufferGetAlignedLogicalAddress

WdfDeviceSetAlignmentRequirement