PCONFIGURE_ADAPTER_CHANNEL funzione di callback (wdm.h)

  • Articolo

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
STATUS_NOT_IMPLEMENTED
 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

Vedi anche

DMA_ADAPTER

DMA_OPERATIONS

IoGetDmaAdapter