Freigeben über


NdisGeneratePartialCancelId-Funktion (ndis.h)

Die NdisGeneratePartialCancelId-Funktion gibt einen Wert zurück, den der aufrufende Treiber als hochgeordnetes Byte einer Abbruch-ID verwenden muss.

Syntax

UCHAR NdisGeneratePartialCancelId();

Rückgabewert

NdisGeneratePartialCancelId gibt einen Wert zurück, den der aufrufende Treiber als hochgeordnetes Byte einer Abbruch-ID verwendet.

Hinweise

Bevor Sie Sende-NET_BUFFER_LIST-Strukturen mit Abbruch-IDs markieren, indem Sie die NDIS_SET_NET_BUFFER_LIST_CANCEL_ID Makro sollte ein Treiber NdisGeneratePartialCancelId mehrmals aufrufen. NdisGeneratePartialCancelId gibt einen Wert zurück, den der aufrufende Treiber als hochgeordnetes Byte einer Abbruch-ID verwenden kann. Wenn Sie einer Abbruch-ID den von NdisGeneratePartialCancelId zurückgegebenen Wert vorangestellt haben, wird sichergestellt, dass die Abbruch-ID kein Duplikat einer Abbruch-ID ist, die von einem anderen Treiber auf dem lokalen Computer zugewiesen wird.

In der Regel ruft ein übersteigender Treiber NdisGeneratePartialCancelId während seiner Initialisierungssequenz ein oder mehrmals auf und speichert den zurückgegebenen Wert oder die zurückgegebenen Werte zur späteren Verwendung. Ein Protokolltreiber könnte z. B. NdisGeneratePartialCancelId einmal für jeden Client (z. B. DHCP oder ARC) aufrufen, den er unterstützt. Der Protokolltreiber kann die NdisCancelSendNetBufferLists-Funktion später, um eine Sendeanforderung abzubrechen. In diesem Fall ruft NDIS die Funktion cancel send (z. B . MiniportCancelSend) der zugrunde liegenden Treiber auf.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisGeneratePartialCancelId (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisGeneratePartialCancelId (NDIS 5.1)) in Windows XP.
Zielplattform Desktop
Kopfzeile ndis.h (include Ndis.h)
Bibliothek Ndis.lib
IRQL <= DISPATCH_LEVEL
DDI-Complianceregeln Irql_Miscellaneous_Function(ndis)

Weitere Informationen

MiniportCancelSend

NDIS_SET_NET_BUFFER_LIST_CANCEL_ID

NET_BUFFER_LIST

NdisCancelSendNetBufferLists