PGET_DMA_ADAPTER_INFO funzione di callback (wdm.h)

Articolo
07.02.2025

La routine GetDmaAdapterInfo recupera informazioni sulle funzionalità hardware di un canale DMA di sistema.

Sintassi

C++

PGET_DMA_ADAPTER_INFO PgetDmaAdapterInfo;

NTSTATUS PgetDmaAdapterInfo(
  [in]      PDMA_ADAPTER DmaAdapter,
  [in, out] PDMA_ADAPTER_INFO AdapterInfo
)
{...}

Parametri

[in] DmaAdapter

Puntatore a una struttura DMA_ADAPTER. Questa struttura è l'oggetto adapter che rappresenta il canale DMA di sistema del driver. Il chiamante ha ottenuto questo puntatore da una chiamata precedente alla routine IoGetDmaAdapter.

[in, out] AdapterInfo

Puntatore a una struttura di DMA_ADAPTER_INFO allocata dal chiamante. La routine scrive informazioni sul controller DMA di sistema in questa struttura. Il chiamante deve impostare il membro version di questa struttura su DMA_ADAPTER_INFO_VERSION1 prima di chiamare GetDmaAdapterInfo.

Valore restituito

GetDmaAdapterInfo restituisce STATUS_SUCCESS se la chiamata ha esito positivo. I possibili valori restituiti dall'errore includono il codice di stato seguente.

Codice restituito	Descrizione
STATUS_NOT_SUPPORTED	La routine non supporta la versione specificata della struttura diXXX DMA_ADAPTER_INFO_.

Osservazioni

GetDmaAdapterInfo 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. Driver ottengono l'indirizzo di questa routine chiamando IoGetDmaAdapter con il membro version del parametro DEVICE_DESCRIPTION_VERSION3 DeviceDescription impostato su DEVICE_DESCRIPTION_VERSION3. Se IoGetDmaAdapter restituisce NULL, la routine non è disponibile nella piattaforma.

GetDmaAdapterInfo recupera le informazioni seguenti:

Numero massimo di elementi in un elenco a dispersione/raccolta che il controller DMA può elaborare in un'unica operazione DMA a dispersione/raccolta.
Larghezza, in bit, di un indirizzo DMA.

Per informazioni sull'adattatore DMA fornito dalla versione 1 della struttura diXXX DMA_ADAPTER_INFO_XXX, vedere DMA_ADAPTER_INFO_V1.

Fabbisogno

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

Vedere anche

DMA_ADAPTER

DMA_ADAPTER_INFO

DMA_OPERATIONS

IoGetDmaAdapter

Condividi tramite