DMA_CHANNELS_CPU_AFFINITY_HANDLER funzione di callback (netdma.h)

Sintassi

DMA_CHANNELS_CPU_AFFINITY_HANDLER DmaChannelsCpuAffinityHandler;

NTSTATUS DmaChannelsCpuAffinityHandler(
  [in] PVOID ProviderContext,
  [in] PNET_DMA_CHANNEL_CPU_AFFINITY CpuAffinityArray,
  [in] ULONG CpuAffinityArraySize
)
{...}

Parametri

[in] ProviderContext

Puntatore che identifica l'area di contesto di un provider DMA. Il driver del provider DMA ha passato questo puntatore a NetDMA in una chiamata a Funzione NetDmaRegisterProvider .

[in] CpuAffinityArray

Puntatore a una matrice di NET_DMA_CHANNEL_CPU_AFFINITY strutture che specificano le affinità CPU per i canali DMA associati al provider DMA.

[in] CpuAffinityArraySize

Lunghezza, in byte, del buffer in CpuAffinityArray .

Valore restituito

ProviderSetDmaChannelCpuAffinity restituisce uno dei valori di stato seguenti:

Commenti

L'interfaccia NetDMA chiama la funzione ProviderSetDmaChannelCpuAffinity di un driver del provider DMA per specificare le affinità DELLA CPU dei canali DMA di un provider DMA. NetDMA chiama ProviderSetDmaChannelCpuAffinity nel contesto di Funzione NetDmaRegisterProvider .

Poiché il numero effettivo di canali DMA non è noto prima dell'avvio di un provider DMA, l'interfaccia NetDMA specifica le affinità della CPU per il numero massimo di canali. Il provider DMA fornisce il numero massimo di canali nel membro MaxDmaChannelCount del NET_DMA_PROVIDER_CHARACTERISTICS struttura che passa alla funzione NetDmaRegisterProvider .

Nei computer che non supportano le piattaforme MSI-X, è possibile specificare le affinità della CPU per i DPC di interruzione, ma non per gli interrupt. In questo caso, l'interfaccia NetDMA specifica un elenco di possibili CPU per l'interrupt DPC nel membro ProcessorAffinityMask del NET_DMA_CHANNEL_PARAMETERS struttura.

Nei computer che supportano MSI-X, il driver del provider DMA può specificare le affinità di interruzione durante la gestione di IRP_MN_FILTER_RESOURCE_REQUIREMENTS IRP.

NetDMA chiama ProviderSetDmaChannelCpuAffinity in IRQL = PASSIVE_LEVEL.

Requisiti

Vedi anche

NET_DMA_CHANNEL_CPU_AFFINITY

NET_DMA_CHANNEL_PARAMETERS

NetDmaRegisterProvider