Función NdisGeneratePartialCancelId (ndis.h)
La función NdisGeneratePartialCancelId devuelve un valor que el controlador que realiza la llamada debe usar como byte de orden superior de un identificador de cancelación.
Sintaxis
UCHAR NdisGeneratePartialCancelId();
Valor devuelto
NdisGeneratePartialCancelId devuelve un valor que el controlador que realiza la llamada usa como byte de orden superior de un identificador de cancelación.
Comentarios
Antes de marcar el envío de estructuras NET_BUFFER_LIST con identificadores de cancelación mediante una llamada a NDIS_SET_NET_BUFFER_LIST_CANCEL_ID macro, un controlador debe llamar a NdisGeneratePartialCancelId una o varias veces. NdisGeneratePartialCancelId devuelve un valor que el controlador que realiza la llamada puede usar como byte de orden superior de un identificador de cancelación. El prefijo de un identificador de cancelación con el valor devuelto por NdisGeneratePartialCancelId garantiza que el identificador de cancelación no sea un duplicado de un identificador de cancelación asignado por otro controlador del equipo local.
Normalmente, un controlador de sobresalida llama a NdisGeneratePartialCancelId una o varias veces durante su secuencia de inicialización y almacena el valor devuelto o los valores para su uso posterior. Un controlador de protocolo, por ejemplo, podría llamar a NdisGeneratePartialCancelId una vez para cada cliente (como DHCP o ARC) que admita. El controlador de protocolo puede llamar al NdisCancelSendNetBufferLists más adelante para cancelar una solicitud de envío. En este caso, NDIS llama a la función cancel send (por ejemplo, MiniportCancelSend) de los controladores subyacentes.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulte NdisGeneratePartiteCancelId (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulta NdisGeneratePartiteCancelId (NDIS 5.1)) en Windows XP. |
| Plataforma de destino | Escritorio |
| Encabezado | ndis.h (incluya Ndis.h) |
| Library | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| Reglas de cumplimiento de DDI | Irql_Miscellaneous_Function(ndis) |