NdisGeneratePartialCancelId (Windows CE 5.0)

Send Feedback

This function returns a value that the calling driver must use as the high-order byte of a cancellation identifier.

UCHAR NdisGeneratePartialCancelId(void);

Parameters

None.

Return Values

A value that the calling driver uses as the high-order byte of a cancellation identifier.

Remarks

Before marking send packets with cancellation identifiers by calling NDIS_SET_PACKET_CANCEL_ID, a protocol or intermediate driver should call NdisGeneratePartialCancelId one or more times. NdisGeneratePartialCancelId returns a value that the calling driver can use as the high-order byte of a cancellation identifier. Prefixing a cancellation identifier with the value returned by NdisGeneratePartialCancelId ensures that the cancellation identifier will not be a duplicate of a cancellation identifier assigned by another driver in the system.

Typically, a protocol or intermediate driver calls NdisGeneratePartialCancelId one or more times during its initialization sequence. The protocol stores the returned value or values for later use. A protocol driver, for example, could call NdisGeneratePartialCancelId once for each client (such as DHCP or ARC) that it supports.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Ndis.h.
Link Library: Ndis.lib

See Also

NdisCancelSendPackets | NdisGetPacketCancelId | NDIS_SET_PACKET_CANCEL_ID

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.