NdisGeneratePartialCancelId-Funktion (ndis.h)
Die NdisGeneratePartialCancelId Funktion gibt einen Wert zurück, den der aufrufende Treiber als Byte mit hoher Reihenfolge einer Abbruch-ID verwenden muss.
Syntax
UCHAR NdisGeneratePartialCancelId();
Rückgabewert
NdisGeneratePartialCancelId einen Wert zurück, den der aufrufende Treiber als Byte mit hoher Reihenfolge einer Abbruch-ID verwendet.
Bemerkungen
Vor dem Markieren NET_BUFFER_LIST Strukturen mit Abbruch-IDs durch Aufrufen der NDIS_SET_NET_BUFFER_LIST_CANCEL_ID Makro sollte ein Treiber NdisGeneratePartialCancelId einmal aufrufen. NdisGeneratePartialCancelId einen Wert zurück, den der aufrufende Treiber als Byte mit hoher Reihenfolge einer Abbruch-ID verwenden kann. Das Präfix einer Abbruch-ID mit dem von NdisGeneratePartialCancelId zurückgegebenen Wert stellt sicher, dass die Abbruch-ID kein Duplikat einer Abbruch-ID sein wird, die von einem anderen Treiber auf dem lokalen Computer zugewiesen wurde.
In der Regel ruft ein übermäßiger Treiber NdisGeneratePartialCancelId mindestens ein Mal während der Initialisierungssequenz auf und speichert den zurückgegebenen Wert oder die zurückgegebenen Werte für die spätere Verwendung. Ein Protokolltreiber kann z. B. NdisGeneratePartialCancelId einmal für jeden client (z. B. DHCP oder ARC) aufrufen, der unterstützt wird. Der Protokolltreiber kann die NdisCancelSendNetBufferLists Funktion später, um eine Sendeanforderung abzubrechen. In diesem Fall ruft NDIS die Cancel Send-Funktion (z. B. MiniportCancelSend) der zugrunde liegenden Treiber auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte 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 |
| Header- | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_Miscellaneous_Function(ndis) |