Функция NdisGeneratePartialCancelId (ndis.h)
Функция NdisGeneratePartialCancelId возвращает значение, которое вызывающий драйвер должен использовать в качестве байта высокого порядка идентификатора отмены.
Синтаксис
UCHAR NdisGeneratePartialCancelId();
Возвращаемое значение
NdisGeneratePartialCancelId возвращает значение, которое вызывающий драйвер использует в качестве байта высокого порядка идентификатора отмены.
Замечания
Перед пометкой отправки NET_BUFFER_LIST структур с идентификаторами отмены путем вызова NDIS_SET_NET_BUFFER_LIST_CANCEL_ID макрос, драйвер должен вызывать NdisGeneratePartialCancelId один или несколько раз. NdisGeneratePartialCancelId возвращает значение, которое вызывающий драйвер может использовать в качестве байта высокого порядка идентификатора отмены. Префикс идентификатора отмены со значением, возвращаемым NdisGeneratePartialCancelId гарантирует, что идентификатор отмены не будет дубликатом идентификатора отмены, назначенного другим драйвером на локальном компьютере.
Как правило, драйвер чрезмерного действия вызывает NdisGeneratePartialCancelId один или несколько раз во время последовательности инициализации и сохраняет возвращаемое значение или значения для последующего использования. Например, драйвер протокола может вызывать NdisGeneratePartialCancelId один раз для каждого клиента (например, DHCP или ARC), который он поддерживает. Драйвер протокола может вызвать функцию NdisCancelSendNetBufferList s позже, чтобы отменить запрос на отправку. В этом случае NDIS вызывает функцию отправки отмены (например, MiniportCancelSend) базовых драйверов.