DMA_RESET_HANDLER funzione di callback (netdma.h)
in Windows 8 e versioni successive.
Sintassi
DMA_RESET_HANDLER DmaResetHandler;
NTSTATUS DmaResetHandler(
[in] PVOID ProviderChannelContext
)
{...}
Parametri
[in] ProviderChannelContext
Puntatore che identifica l'area di contesto di un canale DMA. Il provider DMA ha restituito questo handle a NetDMA nella posizione specificata nel parametro pProviderChannelContext del parametro funzione providerAllocateDmaChannel.
Valore restituito
ProviderResetChannel restituisce uno dei valori di stato seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Operazione completata correttamente. |
|
L'operazione non è riuscita per motivi non specificati. |
Osservazioni
La funzione ProviderResetChannel è una funzione facoltativa per i provider NetDMA. L'interfaccia NetDMA chiama la funzione ProviderResetChannel del driver del provider DMA per reimpostare un canale DMA.
In ProviderResetChannel, il provider NetDMA deve terminare immediatamente qualsiasi trasferimento attivo senza completare il trasferimento dei dati associati al descrittore DMA corrente. Se la segnalazione dello stato di completamento è abilitata, il motore DMA scrive lo stato netDmaTransferStatusHalted nell'indirizzo specificato nell'indirizzo specificato nel CompletionVirtualAddress e CompletionPhysicalAddress membri nel NET_DMA_CHANNEL_PARAMETERS struttura.
Al termine dell'operazione di reimpostazione, il canale DMA deve trovarsi nello stato iniziale esistente dopo l'allocazione del canale. Dopo che l'interfaccia NetDMA chiama ProviderResetChannel, il provider DMA non può accedere a uno dei descrittori DMA precedentemente inviati. Il canale DMA deve essere pronto per l'interfaccia NetDMA per chiamare la funzione ProviderStartDma.
NetDMA chiama ProviderResetChannel in IRQL <= DISPATCH_LEVEL.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Supportato per i driver NetDMA 1.0 in Windows Vista. |
| piattaforma di destinazione | Finestre |
| intestazione | netdma.h (include Netdma.h) |
| IRQL | <= DISPATCH_LEVEL |