PCONFIGURE_ADAPTER_CHANNEL funzione di callback (wdm.h)
La routine ConfigureAdapterChannel richiama una funzione personalizzata implementata dal controller DMA rappresentato da un oggetto adapter.
Sintassi
PCONFIGURE_ADAPTER_CHANNEL PconfigureAdapterChannel;
NTSTATUS PconfigureAdapterChannel(
[in] PDMA_ADAPTER DmaAdapter,
[in] ULONG FunctionNumber,
[in] PVOID Context
)
{...}
Parametri
[in] DmaAdapter
Puntatore a una struttura DMA_ADAPTER . Questa struttura è l'oggetto adapter che rappresenta il canale DMA del sistema del driver. Il chiamante ha ottenuto questo puntatore da una chiamata precedente alla routine IoGetDmaAdapter .
[in] FunctionNumber
Numero della funzione personalizzata da selezionare. Per altre informazioni, vedere la sezione Osservazioni.
[in] Context
Puntatore ai parametri di configurazione per la funzione personalizzata specificata da FunctionNumber. La funzione viene implementata dal controller DMA e può essere accessibile da un driver di dispositivo tramite l'oggetto adapter. Il controller DMA e il driver di dispositivo devono accettare il significato di questi parametri di configurazione. I dati a cui punta Context sono opachi al sistema operativo.
Valore restituito
ConfigureAdapterChannel restituisce STATUS_SUCCESS se la chiamata ha esito positivo. I valori restituiti degli errori possibili includono il codice di stato seguente.
| Valore restituito | Descrizione |
|---|---|
|
L'estensione DMA non implementa la funzione specificata da FunctionNumber. |
Commenti
ConfigureAdapterChannel non è una routine di sistema che può essere chiamata direttamente per nome. Questa routine può essere chiamata solo dal puntatore dall'indirizzo restituito in una struttura DMA_OPERATIONS. I driver ottengono l'indirizzo di questa routine chiamando IoGetDmaAdapter con il membro Version del parametro DeviceDescription impostato su DEVICE_DESCRIPTION_VERSION3. Se IoGetDmaAdapter restituisce NULL, la routine non è disponibile nella piattaforma.
Usare ConfigureAdapterChannel solo per le schede DMA di sistema. Non usare questa routine per un adattatore bus-master.
Un determinato controller DMA di sistema potrebbe avere funzionalità hardware speciali che i driver di dispositivo possono accedere tramite un set di una o più funzioni personalizzate. Un controller può implementare più di una funzione personalizzata, in cui ogni funzione viene identificata da un numero di funzione diverso. Queste funzioni astraggono le funzionalità hardware DMA in modo che le stesse funzioni possano essere supportate in piattaforme hardware diverse.
In genere, una funzione personalizzata imposta le informazioni sullo stato nel controller DMA per configurare le funzionalità hardware da usare nei trasferimenti DMA successivi.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 8. |
| Piattaforma di destinazione | Desktop |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | <= DISPATCH_LEVEL |