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


функция обратного вызова PPUT_DMA_ADAPTER (wdm.h)

Подпрограмма PutDmaAdapter освобождает DMA_ADAPTER структуру, ранее выделенную IoGetDmaAdapter.

Синтаксис

PPUT_DMA_ADAPTER PputDmaAdapter;

void PputDmaAdapter(
  [in] PDMA_ADAPTER DmaAdapter
)
{...}

Параметры

[in] DmaAdapter

Указатель на DMA_ADAPTER структуру, которая должна быть освобождена.

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

None

Remarks

PutDmaAdapter не является системной подпрограммой, которую можно вызывать напрямую по имени. Эта подпрограмма может вызываться только указателем из адреса, возвращенного в структуре DMA_OPERATIONS . Драйверы получают адрес этой подпрограммы, вызывая IoGetDmaAdapter.

PutDmaAdapter освобождает объект адаптера DMA, ранее выделенный IoGetDmaAdapter. Драйверы должны вызывать PutDmaAdapter после завершения операций DMA и освобождения всех регистров карт и общего буфера, выделенных этим объектом адаптера. После возврата PutDmaAdapter драйвер больше не сможет использовать объект адаптера DMA.

Драйвер должен вызывать PutDmaAdapter при получении запроса IRP_MN_STOP_DEVICE PnP.

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows 2000.
Целевая платформа Персональный компьютер
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
IRQL <= DISPATCH_LEVEL
Правила соответствия DDI IrqlDispatch(wdm)

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

DMA_ADAPTER

DMA_OPERATIONS

IoGetDmaAdapter