PALLOCATE_COMMON_BUFFER_WITH_BOUNDS Rückruffunktion (wdm.h)

  • Artikel

Diese Rückruffunktion ordnet den Arbeitsspeicher einem gemeinsamen Puffer zu und ordnet ihn zu, sodass ein master Gerät und die CPU darauf zugreifen können. Der allgemeine Puffer kann durch eine optionale minimale und maximale logische Adresse gebunden werden.

Syntax

PALLOCATE_COMMON_BUFFER_WITH_BOUNDS PallocateCommonBufferWithBounds;

PVOID PallocateCommonBufferWithBounds(
  [in]           PDMA_ADAPTER DmaAdapter,
  [in, optional] PPHYSICAL_ADDRESS MinimumAddress,
  [in, optional] PPHYSICAL_ADDRESS MaximumAddress,
  [in]           ULONG Length,
  [in]           ULONG Flags,
  [in, optional] MEMORY_CACHING_TYPE *CacheType,
  [in]           NODE_REQUIREMENT PreferredNode,
  [out]          PPHYSICAL_ADDRESS LogicalAddress
)
{...}

Parameter

[in] DmaAdapter

Ein Zeiger auf eine DMA_ADAPTER-Struktur. Diese Struktur ist das Adapterobjekt, das den Bus-master DMA-Gerät oder System-DMA-Kanal des Treibers darstellt. Der Aufrufer hat diesen Zeiger aus einem vorherigen Aufruf der IoGetDmaAdapter-Routine abgerufen.

[in, optional] MinimumAddress

Ein Zeiger auf eine Variable, die die minimale logische Adresse für den allgemeinen Puffer enthält. Dieser Parameter gibt an, dass der Puffer aus dem Arbeitsspeicher an und oberhalb dieser Adresse zugeordnet werden soll. Dieser Parameter ist optional und kann als NULL angegeben werden, um anzugeben, dass keine Mindestadresse vorhanden ist.

[in, optional] MaximumAddress

Ein Zeiger auf eine Variable, die die maximale logische Adresse für den allgemeinen Puffer enthält. Dieser Parameter gibt an, dass der Puffer aus dem Speicher unterhalb dieser Adresse zugeordnet werden soll. Dieser Parameter ist optional und kann als NULL angegeben werden, um anzugeben, dass keine maximale Adresse vorhanden ist.

[in] Length

Die Größe des allgemeinen Puffers in Bytes, der für den DMA-Vorgang zugeordnet werden soll.

[in] Flags

Die Größe des allgemeinen Puffers in Bytes, der für den DMA-Vorgang zugeordnet werden soll.

Flag Bedeutung
DOMAIN_COMMON_BUFFER_LARGE_PAGE Der allgemeine Puffer wird mit einer größeren Seitengranularität von PAGE_SIZE * 512 zugeordnet. Beachten Sie, dass dies die Wahrscheinlichkeit erhöhen kann, dass die Zuordnung nicht erfolgreich ist.

[in, optional] CacheType

Ein Zeiger auf eine MEMORY_CACHING_TYPE-Enumeration , der angibt, ob die Routine den zwischengespeicherten Arbeitsspeicher im zuzuordnenden allgemeinen Puffer aktivieren oder deaktivieren muss. Es werden nur Werte von MmNonCached und MmCached unterstützt. Der Parameter ist optional und kann als NULL angegeben werden, um anzugeben, dass die Zwischenspeicherung von der Standardeinstellung der Hardwareplattform abhängig ist.

[in] PreferredNode

Der bevorzugte NUMA-Knoten, aus dem der Arbeitsspeicher zugeordnet werden soll. Wenn N die Anzahl der NUMA-Knoten in einem Multiprozessorsystem ist, ist PreferredNode eine Zahl im Bereich von 0 bis N–1. Legen Sie für ein System mit einem Prozessor oder ein Nicht-NUMA-Multiprozessorsystem PreferredNode auf Null fest.

[out] LogicalAddress

Ein Zeiger auf eine Variable, in die diese Routine die logische Adresse schreibt, die das Gerät für den Zugriff auf den allgemeinen Puffer verwenden kann. Das DMA-Gerät sollte diese logische Adresse anstelle der physischen Adresse verwenden, die von einer Routine wie MmGetPhysicalAddress zurückgegeben wird.

Rückgabewert

Gibt PVOID zurück, die die virtuelle Adresse des Arbeitsspeichers darstellt, der dem allgemeinen Puffer zugeordnet ist. Wenn der Puffer nicht zugeordnet werden kann, wird NULL zurückgegeben.

Hinweise

Diese Rückruffunktion ist eine erweiterte Version der PALLOCATE_COMMON_BUFFER_EX Routine. In der folgenden Liste sind die Features zusammengefasst, die nur in der erweiterten Version verfügbar sind:

  • Der Aufrufer kann eine logische Mindestadresse für den allgemeinen Puffer angeben, der zugeordnet werden soll.

  • Der Aufrufer kann eine Außerkraftsetzung des Cachetyps bereitstellen, die unabhängig von der Hardwareplattform befolgt wird.

  • Der Aufrufer kann die Verwendung einer größeren Granularität für seine allgemeine Pufferzuordnung angeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1803
Zielplattform Desktop
Kopfzeile wdm.h (wdm.h einschließen)
IRQL PASSIVE_LEVEL

Weitere Informationen

DMA_OPERATIONS

PALLOCATE_COMMON_BUFFER_EX