Имена Version-Independent МПП и выбор конкретных версий Windows

Во многих случаях API платформы фильтрации Windows (ВПП) предоставляет несколько версий функции или структуры.

Большинство имен данных и функций в API МПП заканчиваются номером версии, например "0" или "1", даже если существует только одна версия.

Сопоставление версий в fwpvi.h

Файл заголовка fwpvi.h включается начиная с пакета SDK для Windows 7 и WDK. Этот файл заголовка сопоставляет имя API без версии с версией, подходящей для использования с заданной операционной системой.

Например, ниже приведен краткий фрагмент из версии fwpvi.h, включенной в пакет SDK для Windows 8.

#define FwpmNetEventCreateEnumHandle FwpmNetEventCreateEnumHandle0
#if (NTDDI_VERSION >= NTDDI_WIN8)
#define FwpmNetEventEnum FwpmNetEventEnum2
#elif (NTDDI_VERSION >= NTDDI_WIN7)
#define FwpmNetEventEnum FwpmNetEventEnum1
#else
#define FwpmNetEventEnum FwpmNetEventEnum0
#endif

Как показано выше, существует только одна версия FwpmNetEventCreateEnumHandle — FwpmNetEventCreateEnumHandle0 , поэтому любой вызов FwpmNetEventCreateEnumHandle всегда вызывает FwpmNetEventCreateEnumHandle0, независимо от целевой операционной системы.

Однако существует три версии FwpmNetEventEnum: FwpmNetEventEnum0, FwpmNetEventEnum1 и FwpmNetEventEnum2. Файл заголовка fwpvi.h гарантирует, что вызов FwpmNetEventEnum вызовет версию, наиболее подходящую для целевой операционной системы:

• FwpmNetEventEnum2 для Windows 8 (или более поздней версии)
• Целевой объект FwpmNetEventEnum1 для Windows 7
• FwpmNetEventEnum0 для более ранних операционных систем (например, Windows Vista или Windows Vista с пакетом обновления 1 (SP1))

Вызов функций и структур Version-Independent

Разработчикам ВПП, предназначенным для конкретной операционной системы или версии WDK, рекомендуется всегда программировать на основе независимых от версии макросов. Будет автоматически выбрана последняя версия, поддерживаемая в целевой операционной системе. Рекомендуется использовать самые последние файлы заголовков, даже если они предназначены для более ранней операционной системы. Последовательное выполнение этого действия обеспечит использование последней поддерживаемой версии, а также упростит обслуживание и обновление кода.

В справочной документации по API ВПП описана каждая версия нумерованного API. Если существует несколько версий, указывается целевая операционная система. Однако разработчики, как правило, хотят вызывать независимые от версии API и указывать целевую операционную систему (например, NTDDI_WIN6 для Windows Vista или NTDDI_WIN8 для Windows 8).

Чтобы обеспечить правильную обработку функций, которые принимают различные параметры в разных версиях, можно включить условные блоки, такие как #if (NTDDI_VERSION >= NTDDI_WIN7).