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) |