Funzione NdisGeneratePartialCancelId (ndis.h)
La funzione NdisGeneratePartialCancelId restituisce un valore che il driver chiamante deve utilizzare come byte elevato di un ID di annullamento.
Sintassi
UCHAR NdisGeneratePartialCancelId();
Valore restituito
NdisGeneratePartialCancelId restituisce un valore utilizzato dal driver chiamante come byte elevato di un ID di annullamento.
Osservazioni
Prima di contrassegnare le strutture di invio NET_BUFFER_LIST con ID di annullamento chiamando NDIS_SET_NET_BUFFER_LIST_CANCEL_ID macro, un driver deve chiamare NdisGeneratePartialCancelId una o più volte. NdisGeneratePartialCancelId restituisce un valore che il driver chiamante può usare come byte elevato di un ID di annullamento. Il prefisso di un ID di annullamento con il valore restituito da NdisGeneratePartialCancelId garantisce che l'ID di annullamento non sia un duplicato di un ID di annullamento assegnato da un altro driver nel computer locale.
In genere, un driver overlying chiama NdisGeneratePartialCancelId una o più volte durante la sequenza di inizializzazione e archivia il valore o i valori restituiti per un uso successivo. Un driver di protocollo, ad esempio, può chiamare NdisGeneratePartialCancelId una volta per ogni client (ad esempio DHCP o ARC) supportato. Il driver di protocollo può chiamare il NdisCancelSendNetBufferLists funzione in un secondo momento per annullare una richiesta di invio. In questo caso, NDIS chiama la funzione di invio cancel (ad esempio, MiniportCancelSend) dei driver sottostanti.