Funzione WdfCommonBufferGetAlignedVirtualAddress (wdfcommonbuffer.h)

  • Articolo

[Si applica solo a KMDF]

Il metodo WdfCommonBufferGetAlignedVirtualAddress restituisce l'indirizzo virtuale associato a un buffer comune specificato.

Sintassi

PVOID WdfCommonBufferGetAlignedVirtualAddress(
  [in] WDFCOMMONBUFFER CommonBuffer
);

Parametri

[in] CommonBuffer

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

Valore restituito

WdfCommonBufferGetAlignedVirtualAddress restituisce l'indirizzo virtuale 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

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

WdfCommonBufferGetAlignedLogicalAddress

WdfDeviceSetAlignmentRequirement