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();
Valor de retorno
NdisGeneratePartialCancelId retorna um valor que o driver de chamada usa como o byte de alta ordem de uma ID de cancelamento.
Observações
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 o byte de alta ordem de uma ID de cancelamento. A prefixação de uma ID de cancelamento com o valor retornado por NdisGeneratePartialCancelId garante que a ID de cancelamento não seja uma duplicata de uma ID de cancelamento atribuída por outro driver no computador local.
Normalmente, um driver em excesso 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, pode chamar NdisGeneratePartialCancelId uma vez para cada cliente (como DHCP ou ARC) compatível. O driver de protocolo pode chamar o 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.