Condividi tramite


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 per un oggetto buffer comune ottenuto dal driver da una chiamata precedente a WdfCommonBufferCreate.

Valore restituito

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

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Osservazioni

Gli indirizzi logici vengono mappati agli indirizzi usati dai dispositivi 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 Using Common Buffers

Esempi

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

Fabbisogno

Requisito Valore
piattaforma di destinazione Universale
versione minima di KMDF 1.0
intestazione wdfcommonbuffer.h (include WdfCommonBuffer.h)
libreria Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL <= DISPATCH_LEVEL
regole di conformità DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedere anche

WdfCommonBufferCreare

WdfCommonBufferGetAlignedVirtualAddress

WdfDeviceSetAlignmentRequirement