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

Подпрограмма GetDmaAdapterInfo извлекает сведения об аппаратных возможностях системного канала DMA.

Синтаксис

PGET_DMA_ADAPTER_INFO PgetDmaAdapterInfo;

NTSTATUS PgetDmaAdapterInfo(
  [in]      PDMA_ADAPTER DmaAdapter,
  [in, out] PDMA_ADAPTER_INFO AdapterInfo
)
{...}

Параметры

[in] DmaAdapter

Указатель на структуру DMA_ADAPTER . Эта структура является объектом адаптера, который представляет системный канал DMA драйвера. Вызывающий объект получил этот указатель из предыдущего вызова процедуры IoGetDmaAdapter .

[in, out] AdapterInfo

Указатель на структуру, выделенную вызывающим объектом DMA_ADAPTER_INFO . Подпрограмма записывает сведения о системе контроллера DMA в эту структуру. Перед вызовом GetDmaAdapterInfo вызывающий объект должен задать для элемента Version этой структуры значение DMA_ADAPTER_INFO_VERSION1.

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

GetDmaAdapterInfo возвращает STATUS_SUCCESS, если вызов выполнен успешно. Возможные возвращаемые значения ошибок включают следующий код состояния.

Комментарии

GetDmaAdapterInfo не является системной подпрограммой, которую можно вызывать напрямую по имени. Эта подпрограмма может вызываться только указателем из адреса, возвращаемого в структуре DMA_OPERATIONS . Драйверы получают адрес этой подпрограммы, вызывая IoGetDmaAdapter с элементом Version параметра DeviceDescription , равным DEVICE_DESCRIPTION_VERSION3. Если IoGetDmaAdapter возвращает значение NULL, подпрограмма недоступна на вашей платформе.

GetDmaAdapterInfo извлекает следующие сведения:

• Максимальное количество элементов в точечных и собираемых списках, которое контроллер DMA может обработать в рамках одной операции DMA.
• Ширина адреса DMA в битах.

Требования

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

DMA_ADAPTER

DMA_ADAPTER_INFO

DMA_OPERATIONS

IoGetDmaAdapter