Функция NdisGeneratePartialCancelId (ndis.h)
Функция NdisGeneratePartialCancelId возвращает значение, которое вызывающий драйвер должен использовать в качестве байта высокого порядка идентификатора отмены.
Синтаксис
UCHAR NdisGeneratePartialCancelId();
Возвращаемое значение
NdisGeneratePartialCancelId возвращает значение, которое вызывающий драйвер использует в качестве байта высокого порядка идентификатора отмены.
Комментарии
Перед пометкой структуры отправки NET_BUFFER_LIST с идентификаторами отмены путем вызова NDIS_SET_NET_BUFFER_LIST_CANCEL_ID макросе драйвер должен вызывать NdisGeneratePartialCancelId один или несколько раз. NdisGeneratePartialCancelId возвращает значение, которое вызывающий драйвер может использовать в качестве байта высокого порядка идентификатора отмены. Добавление префикса к идентификатору отмены значения, возвращаемого NdisGeneratePartialCancelId , гарантирует, что идентификатор отмены не будет дубликатом идентификатора отмены, назначенного другим драйвером на локальном компьютере.
Как правило, драйвер с избыточностью вызывает NdisGeneratePartialCancelId один или несколько раз во время своей последовательности инициализации и сохраняет возвращаемое значение или значения для последующего использования. Например, драйвер протокола может вызывать NdisGeneratePartialCancelId один раз для каждого клиента (например, DHCP или ARC), который он поддерживает. Драйвер протокола может вызывать Функция NdisCancelSendNetBufferLists позже для отмены запроса на отправку. В этом случае NDIS вызывает функцию cancel send (например, MiniportCancelSend) базовых драйверов.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Поддерживается для драйверов NDIS 6.0 и NDIS 5.1 (см. раздел NdisGeneratePartialCancelId (NDIS 5.1)) в Windows Vista. Поддерживается для драйверов NDIS 5.1 (см. раздел NdisGeneratePartialCancelId (NDIS 5.1)) в Windows XP. |
Целевая платформа | Персональный компьютер |
Верхняя часть | ndis.h (включая Ndis.h) |
Библиотека | Ndis.lib |
IRQL | <= DISPATCH_LEVEL |
Правила соответствия DDI | Irql_Miscellaneous_Function(ndis) |
См. также раздел
NDIS_SET_NET_BUFFER_LIST_CANCEL_IDОбратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по