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)

Consulte también

MiniportCancelSend

NDIS_SET_NET_BUFFER_LIST_CANCEL_ID

NET_BUFFER_LIST

NdisCancelSendNetBufferLists