перечисление WDF_DMA_PROFILE (wdfdmaenabler.h)

Статья
03/22/2025

[Применимо только к KMDF]

Перечисление WDF_DMA_PROFILE определяет типы операций DMA в режиме шины или системного режима, которые могут поддерживать устройства.

Синтаксис

typedef enum _WDF_DMA_PROFILE {
  WdfDmaProfileInvalid = 0,
  WdfDmaProfilePacket,
  WdfDmaProfileScatterGather,
  WdfDmaProfilePacket64,
  WdfDmaProfileScatterGather64,
  WdfDmaProfileScatterGatherDuplex,
  WdfDmaProfileScatterGather64Duplex,
  WdfDmaProfileSystem,
  WdfDmaProfileSystemDuplex
} WDF_DMA_PROFILE;

Константы


`WdfDmaProfileInvalid` Значение: 0 Только для внутреннего использования.
`WdfDmaProfilePacket` Устройство поддерживает операции DMA с одним пакетом, используя 32-разрядную адресацию.
`WdfDmaProfileScatterGather` Устройство поддерживает операции DMA на основе пакетов, точечная и сборная данных с помощью 32-разрядной адресации.
`WdfDmaProfilePacket64` Устройство поддерживает операции DMA с одним пакетом, используя 64-разрядную адресацию.
`WdfDmaProfileScatterGather64` Устройство поддерживает операции DMA на основе пакетов, точечная и сборная данных с использованием 64-разрядной адресации.
`WdfDmaProfileScatterGatherDuplex` Устройство поддерживает операции DMA на основе пакетов, точечная и сборная данных с помощью 32-разрядной адресации. Устройство также поддерживает дуплексную операцию.
`WdfDmaProfileScatterGather64Duplex` Устройство поддерживает операции DMA на основе пакетов, точечная и сборная данных с использованием 64-разрядной адресации. Устройство также поддерживает дуплексную операцию.
`WdfDmaProfileSystem` Устройство поддерживает операции DMA в системном режиме. Это значение доступно в версиях 1.11 и более поздних версиях KMDF, работающих в Windows 8 или более поздних версиях Windows.
`WdfDmaProfileSystemDuplex` Устройство поддерживает операции DMA в системном режиме. Устройство также поддерживает дуплексную операцию. Это значение доступно в версиях 1.11 и более поздних версиях KMDF, работающих в Windows 8 или более поздних версиях Windows.

Замечания

WDF_DMA_PROFILE-типизированные значения используются в WDF_DMA_ENABLER_CONFIG структуре драйвера. Драйвер предоставляет WDF_DMA_ENABLER_CONFIG при вызове WdfDmaEnablerCreate.

Если драйвер выбирает один из профилей DMA в системном режиме, платформа запрашивает интерфейс DMA версии 3 из WDM. Система DMA доступна начиная с Windows 8. Дополнительные сведения о системном режиме DMA см. в поддержке System-Mode DMA.

Kernel-Mode драйверы минипорта Driver Framework (KMDF), такие как мини-порты NDIS, могут запрашивать профили DMA в системном режиме. Сведения о написании драйвера минипорта на основе платформы см. в создании драйверов минипорта на основе платформы.

Требования

Требование	Ценность
минимальная версия KMDF	1.0
Заголовок	wdfdmaenabler.h (include Wdf.h)

См. также

WDF_DMA_ENABLER_CONFIG

Поделиться через