Compartilhar via


estrutura WDF_COMMON_BUFFER_CONFIG (wdfcommonbuffer.h)

[Aplica-se somente ao KMDF]

A estrutura WDF_COMMON_BUFFER_CONFIG contém informações de configuração para um buffer comum.

Sintaxe

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

Membros

Size

O tamanho, em bytes, dessa estrutura.

AlignmentRequirement

O requisito de alinhamento para um buffer comum. Esse valor deve ser um a menos que o limite de alinhamento. Por exemplo, você pode especificar 15 para um limite de alinhamento de 16 bytes e 31 para um limite de alinhamento de 32 bytes. Você também pode usar uma das constantes FILE_Xxxx_ALIGNMENT definidas em Wdm.h.

Comentários

A estrutura WDF_COMMON_BUFFER_CONFIG é usada como entrada para o método WdfCommonBufferCreateWithConfig .

Se o driver especificar um requisito de alinhamento maior que o tamanho da página do computador (PAGE_SIZE), os endereços lógicos que o método WdfCommonBufferGetAlignedLogicalAddress retorna estão sempre alinhados ao requisito de alinhamento especificado, mas os endereços virtuais que o método WdfCommonBufferGetAlignedVirtualAddress retorna podem não estar alinhados ao requisito de alinhamento.

Se o driver especificar um requisito de alinhamento menor que o tamanho da página do computador, todos os endereços lógicos e virtuais serão alinhados ao requisito de alinhamento especificado.

Para obter mais informações sobre como especificar requisitos de alinhamento, consulte Habilitando transações de DMA e usando buffers comuns.

Requisitos

Requisito Valor
Versão mínima do KMDF 1.0
Cabeçalho wdfcommonbuffer.h (inclua WdfCommonBuffer.h)

Confira também

WdfCommonBufferCreateWithConfig

WdfCommonBufferGetAlignedLogicalAddress

WdfCommonBufferGetAlignedVirtualAddress