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_ALIGNMENT xxxx FILE_definidas em Wdm.h.

Observações

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 (PAGE_SIZE) do computador, os endereços lógicos que o WdfCommonBufferGetAlignedLogicalAddress método retornar estarã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 Habilitar de 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)

Consulte também

WdfCommonBufferCreateWithConfig

WdfCommonBufferGetAlignedLogicalAddress

WdfCommonBufferGetAlignedVirtualAddress