NdisMCompleteDmaTransfer-Makro (ndis.h)
Die funktion NdisMCompleteDmaTransfer gibt an, dass ein System-DMA-Übertragungsvorgang abgeschlossen ist. Er setzt den System-DMA-Controller in Vorbereitung auf weitere DMA-Übertragungen zurück.
Syntax
void NdisMCompleteDmaTransfer(
_S,
_H,
_B,
_O,
_L,
_M_
);
Parameter
_S
Ein Zeiger auf eine vom Aufrufer bereitgestellte Variable, in der diese Funktion den endgültigen Status der DMA-Übertragung zurückgibt, die eine der folgenden Sein kann:
NDIS_STATUS_SUCCESS
Die Daten wurden übertragen und geleert, um den Hostspeicher oder das Gerät zu speichern, um die Datenintegrität aufrechtzuerhalten.
NDIS_STATUS_RESOURCES
Der DMA-Controller wurde freigegeben, die Datenübertragung kann jedoch uneinheitlich sein.
_H
Das Handle, das zurückgegeben wird, wenn die MiniportInitializeEx--Funktion aufgerufen wird NdisMRegisterDmaChannel Funktion.
_B
Ein Zeiger auf den Pufferdeskriptor, der zuvor an NdisMSetupDmaTransferübergeben wurde.
_O
Der Byte-Offset, bei dem der Transfer begann. Dieser Wert wurde auch an NdisMSetupDmaTransferübergeben.
_L
Die Länge in Byte der Übertragung. Dieser Wert wurde auch an NdisMSetupDmaTransferübergeben.
_M_
TRUE, wenn die Übertragung vom Host an die NIC erfolgte, z. B. ein Sendevorgang.
Rückgabewert
Nichts
Bemerkungen
NdisMCompleteDmaTransfer- muss mit WriteToDevice aufgerufen werden, auf TRUE festgelegt ist, bevor die übertragenen Daten im Speicher der NIC als vorhanden angesehen werden. NdisMCompleteDmaTransfer- muss mit WriteToDevice aufgerufen werden, auf FALSE festgelegt werden, bevor die übertragenen Daten aus dem Hostspeicher gelesen werden können.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Unterstützt für NDIS 6.0- und NDIS 5.1-Treiber (siehe NdisMCompleteDmaTransfer (NDIS 5.1)) in Windows Vista. Unterstützt für NDIS 5.1-Treiber (siehe NdisMCompleteDmaTransfer (NDIS 5.1)) in Windows XP. |
| Zielplattform- | Universal |
| Header- | ndis.h (include Ndis.h) |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | Irql_MCO_Function(ndis) |