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

Weitere Informationen

MiniportCancelSend

NET_BUFFER_LIST

NdisCancelSendNetBufferLists