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.
Valor de retorno
WdfCommonBufferGetAlignedLogicalAddress retorna o endereço lógico do buffer associado ao buffer comum especificado pelo parâmetro CommonBuffer.
Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.
Observações
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 para 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 |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.0 |
| cabeçalho | wdfcommonbuffer.h (inclua WdfCommonBuffer.h) |
| biblioteca | Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.) |
| IRQL | <= DISPATCH_LEVEL |
| regras de conformidade de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |