IDmaChannelSlave::Start-Methode (portcls.h)

  • Artikel

Die Start-Methode startet ein untergeordnetes DMA-Objekt.

Syntax

NTSTATUS Start(
  ULONG   MapSize,
  BOOLEAN WriteToDevice
);

Parameter

MapSize

Gibt die Anzahl der Bytes des zugeordneten Puffers an, die zugeordnet werden sollen. Die Kartengröße darf die Größe des Puffers, der im Aufruf von IDmaChannel::AllocateBuffer zugeordnet ist, nicht überschreiten.

WriteToDevice

Gibt die Richtung der Datenverschiebung an. True gibt an, dass die Daten aus dem Puffer auf das Gerät verschoben werden. Bei FALSE sollen die Daten vom Gerät in den Puffer verschoben werden.

Rückgabewert

Diese Methode gibt NTSTATUS zurück. Es wird STATUS_SUCCESS zurückgegeben, wenn der Aufruf erfolgreich war. Andernfalls gibt die Methode einen geeigneten Fehlercode zurück. Wenn der Aufrufer versucht, einen kanal zu starten, der bereits gestartet wurde, gibt die Methode sofort mit dem Fehlercode STATUS_UNSUCCESSFUL zurück.

Hinweise

Hinweis

Microsoft unterstützt eine vielfältige und inklusive Umgebung. Dieser Artikel enthält Verweise auf Terminologie, die im Microsoft-Stilleitfaden für voreingenommene Kommunikation als ausschlussfrei erkannt wird. Das Wort oder der Ausdruck wird in diesem Artikel aus Gründen der Konsistenz verwendet, da es derzeit in der Software angezeigt wird. Wenn die Software aktualisiert wird, um die Sprache zu entfernen, wird dieser Artikel aktualisiert, um in Übereinstimmung zu sein.

Die -Methode richtet zunächst Kartenregister ein, um die ersten MapSize-Bytes des zugeordneten Puffers für das Adapterobjekt zuzuordnen. Als Nächstes startet die -Methode eine DMA-Übertragung der in MapSize angegebenen Anzahl von Bytes.

Weitere Informationen zu dieser Methode finden Sie unter IDmaChannel::BufferSize und IDmaChannelSlave::ReadCounter.

Anforderungen

Anforderung Wert
Header portcls.h
IRQL PASSIVE_LEVEL

Weitere Informationen

IDmaChannelSlave-Schnittstelle