Metodo IDmaChannelSlave::WaitForTC (portcls.h)
Il metodo WaitForTC attende il completamento del conteggio del terminale di trasferimento DMA oppure si verifica il timeout se l'intervallo di timeout specificato scade per primo.
Sintassi
NTSTATUS WaitForTC(
ULONG Timeout
);
Parametri
Timeout
Specifica l'intervallo di timeout in microsecondi. Questo intervallo è l'intervallo di tempo durante il quale il metodo attende il completamento del trasferimento prima del timeout. L'intervallo di timeout specificato viene arrotondato per difetto all'incremento di dieci microsecondi più vicino.
Valore restituito
Il metodo WaitForTC restituisce NTSTATUS. Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, il metodo restituisce un codice di errore appropriato.
Commenti
Nota
Microsoft supporta un ambiente diversificato e inclusivo. Questo articolo contiene riferimenti alla terminologia riconosciuta dalla guida di stile Microsoft per le comunicazioni senza distorsioni 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 in modo che sia allineato.
Questo metodo deve essere chiamato solo in due situazioni:
Dopo aver inviato una richiesta all'hardware per arrestarsi, il driver miniport chiama WaitForTC per attendere il completamento di DMA prima di continuare l'esecuzione.
Nel caso di hardware DMA non inizializzato automaticamente, il driver miniport può chiamare WaitForTC in qualsiasi momento per attendere il completamento di un trasferimento DMA.
Poiché questo metodo attende semplicemente il completamento o il timeout del trasferimento DMA, i chiamanti di WaitForTC devono essere in esecuzione in irQL PASSIVE_LEVEL.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | portcls.h |
| IRQL | PASSIVE_LEVEL (vedere la sezione Osservazioni). |