Compartilhar via


Função NdisGeneratePartialCancelId (ndis.h)

A função NdisGeneratePartialCancelId retorna um valor que o driver de chamada deve usar como byte de alta ordem de uma ID de cancelamento.

Sintaxe

UCHAR NdisGeneratePartialCancelId();

Retornar valor

NdisGeneratePartialCancelId retorna um valor que o driver de chamada usa como byte de alta ordem de uma ID de cancelamento.

Comentários

Antes de marcar enviar NET_BUFFER_LIST estruturas com IDs de cancelamento chamando o NDIS_SET_NET_BUFFER_LIST_CANCEL_ID macro, um driver deve chamar NdisGeneratePartialCancelId uma ou mais vezes. NdisGeneratePartialCancelId retorna um valor que o driver de chamada pode usar como byte de alta ordem de uma ID de cancelamento. Prefixar uma ID de cancelamento com o valor retornado por NdisGeneratePartialCancelId garante que a ID de cancelamento não será uma duplicata de uma ID de cancelamento atribuída por outro driver no computador local.

Normalmente, um driver sobreposto chama NdisGeneratePartialCancelId uma ou mais vezes durante sua sequência de inicialização e armazena o valor ou valores retornados para uso posterior. Um driver de protocolo, por exemplo, poderia chamar NdisGeneratePartialCancelId uma vez para cada cliente (como DHCP ou ARC) que ele dá suporte. O driver de protocolo pode chamar o A função NdisCancelSendNetBufferLists posteriormente para cancelar uma solicitação de envio. Nesse caso, o NDIS chama a função cancelar envio (por exemplo, MiniportCancelSend) dos drivers subjacentes.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisGeneratePartialCancelId (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisGeneratePartialCancelId (NDIS 5.1)) no Windows XP.
Plataforma de Destino Área de Trabalho
Cabeçalho ndis.h (inclua Ndis.h)
Biblioteca Ndis.lib
IRQL <= DISPATCH_LEVEL
Regras de conformidade de DDI Irql_Miscellaneous_Function(ndis)

Confira também

MiniportCancelSend

NDIS_SET_NET_BUFFER_LIST_CANCEL_ID

NET_BUFFER_LIST

NdisCancelSendNetBufferLists