Funzione NdisGeneratePartialCancelId (ndis.h)

  • Articolo

La funzione NdisGeneratePartialCancelId restituisce un valore che il driver chiamante deve usare come byte elevato di un ID di annullamento.

Sintassi

UCHAR NdisGeneratePartialCancelId();

Valore restituito

NdisGeneratePartialCancelId restituisce un valore usato dal driver chiamante come byte elevato di un ID di annullamento.

Commenti

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 di ordine 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 sarà 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, potrebbe chiamare NdisGeneratePartialCancelId una volta per ogni client (ad esempio DHCP o ARC) supportato. Il driver del protocollo può chiamare il Funzione NdisCancelSendNetBufferLists successivamente per annullare una richiesta di invio. In questo caso, NDIS chiama la funzione di invio annulla (ad esempio , MiniportCancelSend) dei driver sottostanti.

Requisiti

Requisito Valore
Client minimo supportato Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisGeneratePartialCancelId (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisGeneratePartialCancelId (NDIS 5.1) in Windows XP.
Piattaforma di destinazione Desktop
Intestazione ndis.h (includere Ndis.h)
Libreria Ndis.lib
IRQL <= DISPATCH_LEVEL
Regole di conformità DDI Irql_Miscellaneous_Function(ndis)

Vedi anche

MiniportCancelSend

NDIS_SET_NET_BUFFER_LIST_CANCEL_ID

NET_BUFFER_LIST

NdisCancelSendNetBufferLists