WDF_COMMON_BUFFER_CONFIG-Struktur (wdfcommonbuffer.h)

  • Artikel

[Gilt nur für KMDF]

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

Syntax

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

Member

Size

Die Größe (in Bytes) dieser Struktur.

AlignmentRequirement

Die Ausrichtungsanforderung für einen gemeinsamen Puffer. Dieser Wert muss um eins kleiner als die Ausrichtungsgrenze sein. Sie können beispielsweise 15 für eine 16-Byte-Ausrichtungsgrenze und 31 für eine 32-Byte-Ausrichtungsgrenze angeben. Sie können auch eine der in Wdm.h definierten FILE_Xxxx_ALIGNMENT Konstanten verwenden.

Hinweise

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

Wenn Ihr Treiber eine Ausrichtungsanforderung angibt, die höher als die Seitengröße des Computers (PAGE_SIZE) ist, werden die logischen Adressen, die die WdfCommonBufferGetAlignedLogicalAddress-Methode zurückgibt, immer an der angegebenen Ausrichtungsanforderung ausgerichtet, aber die virtuellen Adressen, die die WdfCommonBufferGetAlignedVirtualAddress-Methode zurückgibt, sind möglicherweise nicht an der Ausrichtungsanforderung ausgerichtet.

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

Weitere Informationen zum Angeben von Ausrichtungsanforderungen finden Sie unter Aktivieren von DMA-Transaktionen und Verwenden von allgemeinen Puffern.

Anforderungen

Anforderung Wert
KMDF-Mindestversion 1.0
Kopfzeile wdfcommonbuffer.h (einschließen von WdfCommonBuffer.h)

Weitere Informationen

WdfCommonBufferCreateWithConfig

WdfCommonBufferGetAlignedLogicalAddress

WdfCommonBufferGetAlignedVirtualAddress