PGET_DMA_ADAPTER_INFO funzione di callback (wdm.h)

Articolo
03/08/2023

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

Sintassi

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 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 valori restituiti di errore possibili includono il codice di stato seguente.

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

Commenti

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

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 DMA_ADAPTER_INFO_XXX , vedere DMA_ADAPTER_INFO_V1.

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

Condividi tramite