Funzione NdisGeneratePartialCancelId (ndis.h)
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) |