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) |