Compartilhar via


Função WdfCommonBufferGetAlignedLogicalAddress (wdfcommonbuffer.h)

[Aplica-se somente ao KMDF]

O método WdfCommonBufferGetAlignedLogicalAddress retorna o endereço lógico associado a um buffer comum especificado.

Sintaxe

PHYSICAL_ADDRESS WdfCommonBufferGetAlignedLogicalAddress(
  [in] WDFCOMMONBUFFER CommonBuffer
);

Parâmetros

[in] CommonBuffer

Um identificador para um objeto de buffer comum que o driver obteve por uma chamada anterior para WdfCommonBufferCreate.

Retornar valor

WdfCommonBufferGetAlignedLogicalAddress retorna o endereço lógico do buffer associado ao buffer comum especificado pelo parâmetro CommonBuffer .

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

Endereços lógicos são endereços mapeados que os dispositivos usam para acessar a memória física.

Se o driver chamado WdfDeviceSetAlignmentRequirement definir um requisito de alinhamento de buffer, a estrutura alinhará o buffer comum de acordo com esse requisito de alinhamento.

Para obter mais informações sobre buffers comuns, consulte Usando buffers comuns

Exemplos

Para obter um exemplo de código que usa WdfCommonBufferGetAlignedLogicalAddress, consulte WdfCommonBufferCreate.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Cabeçalho wdfcommonbuffer.h (inclua WdfCommonBuffer.h)
Biblioteca Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.)
IRQL <= DISPATCH_LEVEL
Regras de conformidade de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

WdfCommonBufferCreate

WdfCommonBufferGetAlignedVirtualAddress

WdfDeviceSetAlignmentRequirement