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

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

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

 

Функция NetDmaGetVersion возвращает версию интерфейса NetDMA, который поддерживает локальный компьютер.

Синтаксис

NET_DMA_EXPORT UINT NetDmaGetVersion();

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

NetDmaGetVersion возвращает значение UINT, содержащее основные и дополнительные номера версий следующим образом:

Код возврата Описание
Высокий 16 бит
 Основной номер версии интерфейса NetDMA.
Низкий 16 бит
 Дополнительная версия интерфейса NetDMA.

Комментарии

Драйверы поставщика NetDMA могут вызывать функцию NetDmaGetVersion , чтобы получить версию интерфейса NetDMA. Поставщик NetDMA должен регистрироваться в качестве поставщика NetDMA с версией, которая не соответствует версии интерфейса поставщика NetDMA, которую поддерживает локальный компьютер. Драйвер поставщика NetDMA указывает основную и дополнительную версии поставщика NetDMA в элементах MajorVersion и MinorVersion NET_DMA_PROVIDER_CHARACTERISTICS структуры, которая передается в Функция NetDmaRegisterProvider .

Примечание. NetDmaGetVersion недоступна в NetDMA версии 1.0. Чтобы избежать использования функции импорта, которая может остановить загрузку драйвера, драйвер поставщика NetDMA 1.1 или более поздней версии должен проверить наличие NetDmaGetVersion перед вызовом NetDmaGetVersion. Чтобы вызвать NetDmaGetVersion, сначала вызовите функцию NdisGetRoutineAddress , чтобы получить точку входа, а затем, если NetDmaGetVersion доступна, вызовите NetDmaGetVersion в точке входа, предоставленной NdisGetRoutineAddress . Если драйвер поставщика не может получить адрес NetDmaGetVersion, поддерживаемый интерфейс NetDMA должен быть версии 1.0.
 
Драйверы поставщика NetDMA вызывают NetDmaGetVersion по адресу IRQL = PASSIVE_LEVEL.

Требования

Требование Значение
Минимальная версия клиента Поддерживается для драйверов NetDMA 2.0 и NetDMA 1.1 в Windows Server 2008.
Целевая платформа Универсальное
Верхняя часть netdma.h (включая Netdma.h)
IRQL PASSIVE_LEVEL

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

NET_DMA_PROVIDER_CHARACTERISTICS

NdisGetRoutineAddress

NetDmaRegisterProvider