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 de llamada usa como byte de orden superior de un identificador de cancelación.
Observaciones
Antes de marcar las estructuras de NET_BUFFER_LIST con identificadores de cancelación llamando 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 de 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 demasiado excesivo llama a NdisGeneratePartiteCancelId una o varias veces durante su secuencia de inicialización y almacena el valor devuelto o los valores para su uso posterior. Por ejemplo, un controlador de protocolo podría llamar a NdisGeneratePartiteCancelId una vez para cada cliente (como DHCP o ARC) que admita. El controlador de protocolo puede llamar a NdisCancelSendNetBufferLists función 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 | Valor |
|---|---|
| cliente mínimo admitido | 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 (consulte NdisGeneratePartiteCancelId (NDIS 5.1)) en Windows XP. |
| de la plataforma de destino de | Escritorio |
| encabezado de | ndis.h (incluya Ndis.h) |
| biblioteca de | Ndis.lib |
| irQL | <= DISPATCH_LEVEL |
| reglas de cumplimiento de DDI | Irql_Miscellaneous_Function(ndis) |