Metodo IDmaChannelSlave::Start (portcls.h)

Il metodo Start avvia un oggetto DMA subordinato.

Sintassi

NTSTATUS Start(
  ULONG   MapSize,
  BOOLEAN WriteToDevice
);

Parametri

MapSize

Specifica il numero di byte del buffer allocato di cui eseguire il mapping. Le dimensioni della mappa non devono superare le dimensioni del buffer allocato nella chiamata a IDmaChannel::AllocateBuffer.

WriteToDevice

Specifica la direzione dello spostamento dei dati. Se TRUE, i dati devono essere spostati dal buffer al dispositivo. Se FALSE, i dati devono essere spostati dal dispositivo al buffer.

Valore restituito

Questo metodo restituisce NTSTATUS. Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, il metodo restituisce un codice di errore appropriato. Se il chiamante tenta di avviare un canale già avviato, il metodo restituisce immediatamente il codice di errore STATUS_UNSUCCESSFUL.

Osservazioni

Nota

Microsoft supporta un ambiente diversificato e inclusivo. Questo articolo contiene riferimenti alla terminologia riconosciuta dalla guida di stile Microsoft per la comunicazione senza pregiudizi come esclusioni. La parola o la frase viene usata in questo articolo per coerenza perché è attualmente presente nel software. Quando il software viene aggiornato per rimuovere la lingua, questo articolo verrà aggiornato per essere allineato.

Il metodo configura prima i registri mappa per eseguire il mapping dei primi byte MapSize del buffer allocato per l'oggetto adapter. Successivamente, il metodo avvia un trasferimento DMA del numero di byte specificato in MapSize.

Per altre informazioni su questo metodo, vedere IDmaChannel::BufferSize e IDmaChannelSlave::ReadCounter.

Fabbisogno

Requisito	Valore
intestazione	portcls.h
IRQL	PASSIVE_LEVEL

Vedere anche

interfaccia IDmaChannelSlave