WdfCommonBufferGetAlignedLogicalAddress-Funktion (wdfcommonbuffer.h)

[Gilt nur für KMDF]

Die WdfCommonBufferGetAlignedLogicalAddress-Methode gibt die logische Adresse zurück, die einem angegebenen allgemeinen Puffer zugeordnet ist.

Syntax

PHYSICAL_ADDRESS WdfCommonBufferGetAlignedLogicalAddress(
  [in] WDFCOMMONBUFFER CommonBuffer
);

Parameter

[in] CommonBuffer

Ein Handle für ein allgemeines Pufferobjekt, das der Treiber durch einen vorherigen Aufruf von WdfCommonBufferCreate abgerufen hat.

Rückgabewert

WdfCommonBufferGetAlignedLogicalAddress gibt die logische Adresse des Puffers zurück, die dem allgemeinen Puffer zugeordnet ist, den der CommonBuffer-Parameter angibt.

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Hinweise

Logische Adressen sind zugeordnete Adressen, die Geräte für den Zugriff auf physischen Arbeitsspeicher verwenden.

Wenn der Treiber WdfDeviceSetAlignmentRequirement heißt, um eine Pufferausrichtungsanforderung festzulegen, richtet das Framework den allgemeinen Puffer entsprechend dieser Ausrichtungsanforderung aus.

Weitere Informationen zu allgemeinen Puffern finden Sie unter Verwenden allgemeiner Puffer.

Beispiele

Ein Codebeispiel, das WdfCommonBufferGetAlignedLogicalAddress verwendet, finden Sie unter WdfCommonBufferCreate.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
Kopfzeile	wdfcommonbuffer.h (einschließen von WdfCommonBuffer.h)
Bibliothek	Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.)
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

WdfCommonBufferCreate

WdfCommonBufferGetAlignedVirtualAddress

WdfDeviceSetAlignmentRequirement