Функция 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) |