функция WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT (wdfdmaenabler.h)

Статья
02/27/2024

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

Функция WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT инициализирует структуру WDF_DMA_SYSTEM_PROFILE_CONFIG драйвера.

Синтаксис

void WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT(
       PWDF_DMA_SYSTEM_PROFILE_CONFIG  DmaConfig,
  [in] PHYSICAL_ADDRESS                Address,
  [in] DMA_WIDTH                       DmaWidth,
  [in] PCM_PARTIAL_RESOURCE_DESCRIPTOR DmaDescriptor
);

Параметры

DmaConfig

Указатель на структуру, выделенную драйвером WDF_DMA_SYSTEM_PROFILE_CONFIG .

[in] Address

Преобразованный адрес регистра для целевого объекта DMA. Дополнительные сведения см. в подразделе "Примечания".

[in] DmaWidth

Ширина регистра, указанная параметром Address.

[in] DmaDescriptor

Переведенный дескриптор ресурса для канала DMA назначил устройству во время EvtDevicePrepareHardware.

Возвращаемое значение

None

Remarks

Как правило, драйвер вызывает WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT из функции обратного вызова EvtDevicePrepareHardware . Драйвер должен вызвать функцию WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT перед вызовом WdfDmaEnablerConfigureSystemProfile.

В зависимости от структуры Системы на микросхеме (SoC) параметр Address может иметь другое значение. Например, если DMA использует выделенные порты передачи на устройстве, адрес может указывать порт, на который выполняется запись DMA.

Дополнительные сведения о создании включения DMA в системном режиме см. в разделе Поддержка System-Mode DMA.

Примеры

Пример кода, в котором используется WDF_DMA_SYSTEM_PROFILE_CONFIG_INIT, см. в разделе WdfDmaEnablerConfigureSystemProfile.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8
Целевая платформа	Универсальное
Минимальная версия KMDF	1.11
Верхняя часть	wdfdmaenabler.h (включая Wdf.h)

См. также раздел

WDF_DMA_SYSTEM_PROFILE_CONFIG

WdfDmaEnablerConfigureSystemProfile

WdfDmaEnablerCreate