Função WdfCommonBufferGetAlignedVirtualAddress (wdfcommonbuffer.h)

[Aplica-se somente ao KMDF]

O método WdfCommonBufferGetAlignedVirtualAddress retorna o endereço virtual associado a um buffer comum especificado.

Sintaxe

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

WdfCommonBufferGetAlignedVirtualAddress retorna o endereço virtual 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

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

WdfCommonBufferGetAlignedLogicalAddress

WdfDeviceSetAlignmentRequirement