DMA_CHANNELS_CPU_AFFINITY_HANDLER fungsi panggilan balik (netdma.h)

Artikel
02/29/2024

Catatan Antarmuka NetDMA tidak didukung

di Windows 8 dan yang lebih baru.

Fungsi ProviderSetDmaChannelCpuAffinity menetapkan afinitas CPU untuk saluran DMA yang terkait dengan penyedia DMA.

Sintaks

DMA_CHANNELS_CPU_AFFINITY_HANDLER DmaChannelsCpuAffinityHandler;

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

Parameter

[in] ProviderContext

Pointer yang mengidentifikasi area konteks penyedia DMA. Driver penyedia DMA meneruskan pointer ini ke NetDMA dalam panggilan ke Fungsi NetDmaRegisterProvider .

[in] CpuAffinityArray

Penunjuk ke array dari NET_DMA_CHANNEL_CPU_AFFINITY struktur yang menentukan afinitas CPU untuk saluran DMA yang terkait dengan penyedia DMA.

[in] CpuAffinityArraySize

Panjangnya, dalam byte, dari buffer di CpuAffinityArray .

Nilai kembali

ProviderSetDmaChannelCpuAffinity mengembalikan salah satu nilai status berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Operasi berhasil diselesaikan.
STATUS_RESOURCES	Operasi gagal karena sumber daya yang tidak mencukup.
STATUS_UNSUCCESSFUL	Operasi gagal karena alasan yang tidak ditentukan.

Keterangan

Antarmuka NetDMA memanggil fungsi ProviderSetDmaChannelCpuAffinity penyedia DMA untuk menentukan afinitas CPU saluran DMA penyedia DMA. NetDMA memanggil ProviderSetDmaChannelCpuAffinity saat berada dalam konteks Fungsi NetDmaRegisterProvider .

Karena jumlah saluran DMA yang sebenarnya tidak diketahui sebelum penyedia DMA dimulai, antarmuka NetDMA menentukan afinitas CPU untuk jumlah saluran maksimum. Penyedia DMA menyediakan jumlah maksimum saluran di anggota MaxDmaChannelCount NET_DMA_PROVIDER_CHARACTERISTICS struktur yang diteruskannya ke fungsi NetDmaRegisterProvider .

Pada komputer yang tidak mendukung platform MSI-X, afinitas CPU dapat ditentukan untuk DPC yang mengganggu tetapi tidak untuk gangguan. Dalam hal ini, antarmuka NetDMA menentukan daftar kemungkinan CPU untuk DPC interupsi di anggota ProcessorAffinityMask dari NET_DMA_CHANNEL_PARAMETERS struktur.

Pada komputer yang mendukung MSI-X, driver penyedia DMA dapat menentukan afinitas interupsi saat menangani IRP_MN_FILTER_RESOURCE_REQUIREMENTS IRP.

NetDMA memanggil ProviderSetDmaChannelCpuAffinity di IRQL = PASSIVE_LEVEL.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung untuk driver NetDMA 1.0 di Windows Vista.
Target Platform	Windows
Header	netdma.h (termasuk Netdma.h)
IRQL	PASSIVE_LEVEL