Функция 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 вызывает функцию отмены отправки (например, 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)

См. также

MiniportCancelSend

NDIS_SET_NET_BUFFER_LIST_CANCEL_ID

NET_BUFFER_LIST

NdisCancelSendNetBufferLists