WDF_COMMON_BUFFER_CONFIG estructura (wdfcommonbuffer.h)

  • Artículo

[Solo se aplica a KMDF]

La estructura WDF_COMMON_BUFFER_CONFIG contiene información de configuración para un búfer común.

Sintaxis

typedef struct _WDF_COMMON_BUFFER_CONFIG {
  ULONG Size;
  ULONG AlignmentRequirement;
} WDF_COMMON_BUFFER_CONFIG, *PWDF_COMMON_BUFFER_CONFIG;

Miembros

Size

Tamaño, en bytes, de esta estructura.

AlignmentRequirement

Requisito de alineación para un búfer común. Este valor debe ser uno menor que el límite de alineación. Por ejemplo, puede especificar 15 para un límite de alineación de 16 bytes y 31 para un límite de alineación de 32 bytes. También puede usar una de las constantes FILE_Xxxx_ALIGNMENT que se definen en Wdm.h.

Comentarios

La estructura WDF_COMMON_BUFFER_CONFIG se usa como entrada para el método WdfCommonBufferCreateWithConfig .

Si el controlador especifica un requisito de alineación que es mayor que el tamaño de página del equipo (PAGE_SIZE), las direcciones lógicas que devuelve el método WdfCommonBufferGetAlignedLogicalAddress siempre se alinean con el requisito de alineación especificado, pero es posible que las direcciones virtuales que devuelve el método WdfCommonBufferGetAlignedVirtualAddress no se alineen con el requisito de alineación.

Si el controlador especifica un requisito de alineación menor que el tamaño de página del equipo, todas las direcciones lógicas y virtuales se alinean con el requisito de alineación especificado.

Para obtener más información sobre cómo especificar los requisitos de alineación, consulte Habilitación de transacciones DMA y Uso de búferes comunes.

Requisitos

Requisito Value
Versión mínima de KMDF 1.0
Encabezado wdfcommonbuffer.h (incluya WdfCommonBuffer.h)

Consulte también

WdfCommonBufferCreateWithConfig

WdfCommonBufferGetAlignedLogicalAddress

WdfCommonBufferGetAlignedVirtualAddress