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


Функция NetDmaProviderStart (netdma.h)

Примечание Интерфейс NetDMA не поддерживается

в Windows 8 и более поздних версиях.

 
Функция NetDmaProviderStart уведомляет интерфейс NetDMA о том, что все каналы DMA, связанные с поставщиком DMA, инициализированы и готовы к передаче DMA.

Синтаксис

NET_DMA_EXPORT VOID NetDmaProviderStart(
  [in] PVOID                        NetDmaProviderHandle,
  [in] PNET_DMA_PROVIDER_ATTRIBUTES ProviderAttributes
);

Параметры

[in] NetDmaProviderHandle

Дескриптор, определяющий поставщика DMA. Драйвер поставщика DMA получил этот дескриптор из интерфейса NetDMA в вызове функцию NetDmaRegisterProvider.

[in] ProviderAttributes

Указатель на NET_DMA_PROVIDER_ATTRIBUTES структура, которая определяет атрибуты устройства DMA поставщика DMA.

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

Никакой

Замечания

Поставщики DMA вызывают функцию NetDmaProviderStart, чтобы уведомить интерфейс NetDMA о запуске поставщика DMA. Драйвер поставщика DMA инициализирует подсистему DMA и вызывает функцию NetDmaProviderStart при обработке IRP_MN_START_DEVICE IRP.

Драйвер поставщика DMA также может вызывать NetDmaProviderStart после того, как драйвер вызвал функцию NetDmaProviderStop по конкретным причинам. Драйверы поставщика DMA вызывают вызов NetDmaProviderStop, чтобы уведомить интерфейс NetDMA о том, что ранее запущенный поставщик DMA больше недоступен.

Драйвер поставщика DMA предоставляет NET_DMA_PROVIDER_ATTRIBUTES структура ProviderAttributes параметра NetDmaProviderStart. Структура NET_DMA_PROVIDER_ATTRIBUTES указывает атрибуты конфигурации для поставщика NetDMA.

Прежде чем драйвер поставщика DMA вызывает NetDmaProviderStart, он должен быть готов к обработке всех запросов интерфейса NetDMA, таких как выделение каналов DMA и выполнение передачи DMA.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Поддерживается для драйверов NetDMA 1.0 в Windows Vista.
целевая платформа Всеобщий
заголовка netdma.h (include Netdma.h)
IRQL PASSIVE_LEVEL

См. также

IRP_MN_START_DEVICE

NET_DMA_PROVIDER_ATTRIBUTES

NetDmaProviderStop

NetDmaRegisterProvider