Freigeben über


WDF_COMMON_BUFFER_CONFIG Struktur (wdfcommonbuffer.h)

[Gilt nur für KMDF]

Die WDF_COMMON_BUFFER_CONFIG-Struktur enthält Konfigurationsinformationen für einen allgemeinen Puffer.

Syntax

typedef struct _WDF_COMMON_BUFFER_CONFIG {
  ULONG Size;
  ULONG AlignmentRequirement;
} WDF_COMMON_BUFFER_CONFIG, *PWDF_COMMON_BUFFER_CONFIG;

Angehörige

Size

Die Größe dieser Struktur in Byte.

AlignmentRequirement

Die Ausrichtungsanforderung für einen allgemeinen Puffer. Dieser Wert muss ein Wert kleiner sein als die Ausrichtungsgrenze. Sie können z. B. 15 für eine 16-Byte-Ausrichtungsgrenze und 31 für eine 32-Byte-Ausrichtungsgrenze angeben. Sie können auch eine der FILE_Xxxx_ALIGNMENT Konstanten verwenden, die in Wdm.h-definiert sind.

Bemerkungen

Die WDF_COMMON_BUFFER_CONFIG-Struktur wird als Eingabe für die WdfCommonBufferCreateWithConfig-Methode verwendet.

Wenn Ihr Treiber eine Ausrichtungsanforderung angibt, die größer ist als die Seitengröße des Computers (PAGE_SIZE), werden die logischen Adressen, die die WdfCommonBufferGetAlignedLogicalAddress -Methode zurückgegeben wird, immer an die angegebene Ausrichtungsanforderung ausgerichtet, aber die virtuellen Adressen, die die WdfCommonBufferGetAlignedVirtualAddress Methode zurückgeben, werden möglicherweise nicht an die Ausrichtungsanforderung ausgerichtet.

Wenn Ihr Treiber eine Ausrichtungsanforderung angibt, die kleiner als die Seitengröße des Computers ist, werden alle logischen und virtuellen Adressen an die angegebene Ausrichtungsanforderung ausgerichtet.

Weitere Informationen zum Angeben von Ausrichtungsanforderungen finden Sie unter Aktivieren von DMA-Transaktionen und Using Common Buffers.

Anforderungen

Anforderung Wert
Minimale KMDF-Version 1.0
Header- wdfcommonbuffer.h (include WdfCommonBuffer.h)

Siehe auch

WdfCommonBufferCreateWithConfig

WdfCommonBufferGetAlignedLogicalAddress

WdfCommonBufferGetAlignedVirtualAddress