Funzione WdfCommonBufferGetAlignedLogicalAddress (wdfcommonbuffer.h)

[Si applica solo a KMDF]

Il metodo WdfCommonBufferGetAlignedLogicalAddress restituisce l'indirizzo logico associato a un buffer comune specificato.

Sintassi

PHYSICAL_ADDRESS WdfCommonBufferGetAlignedLogicalAddress(
  [in] WDFCOMMONBUFFER CommonBuffer
);

Parametri

[in] CommonBuffer

Handle a un oggetto buffer comune ottenuto da una chiamata precedente a WdfCommonBufferCreate.

Valore restituito

WdfCommonBufferGetAlignedLogicalAddress restituisce l'indirizzo logico del buffer associato al buffer comune specificato dal parametro CommonBuffer .

Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.

Commenti

Gli indirizzi logici vengono mappati che i dispositivi usano per accedere alla memoria fisica.

Se il driver denominato WdfDeviceSetAlignmentRequirement per impostare un requisito di allineamento del buffer, il framework allinea il buffer comune in base a tale requisito di allineamento.

Per altre informazioni sui buffer comuni, vedere Uso di buffer comuni

Esempio

Per un esempio di codice che usa WdfCommonBufferGetAlignedLogicalAddress, vedere WdfCommonBufferCreate.

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Intestazione wdfcommonbuffer.h (include WdfCommonBuffer.h)
Libreria Wdf01000.sys (vedere Framework Library Versioning).
IRQL <= DISPATCH_LEVEL
Regole di conformità DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

WdfCommonBufferCreate

WdfCommonBufferGetAlignedVirtualAddress

WdfDeviceSetAlignmentRequirement