DMA_CHANNELS_CPU_AFFINITY_HANDLER fonction de rappel (netdma.h)
dans Windows 8 et versions ultérieures.
Syntaxe
DMA_CHANNELS_CPU_AFFINITY_HANDLER DmaChannelsCpuAffinityHandler;
NTSTATUS DmaChannelsCpuAffinityHandler(
[in] PVOID ProviderContext,
[in] PNET_DMA_CHANNEL_CPU_AFFINITY CpuAffinityArray,
[in] ULONG CpuAffinityArraySize
)
{...}
Paramètres
[in] ProviderContext
Pointeur qui identifie la zone de contexte d’un fournisseur DMA. Le pilote du fournisseur DMA a passé ce pointeur à NetDMA dans un appel au fonction NetDmaRegisterProvider.
[in] CpuAffinityArray
Pointeur vers un tableau de NET_DMA_CHANNEL_CPU_AFFINITY structures qui spécifient les affinités processeur pour les canaux DMA associés au fournisseur DMA.
[in] CpuAffinityArraySize
Longueur, en octets, de la mémoire tampon à CpuAffinityArray .
Valeur de retour
ProviderSetDmaChannelCpuAffinity retourne l’une des valeurs d’état suivantes :
| Retourner le code | Description |
|---|---|
|
L’opération s’est terminée avec succès. |
|
L’opération a échoué en raison de ressources insuffisantes. |
|
L’opération a échoué pour des raisons non spécifiées. |
Remarques
L’interface NetDMA appelle la fonction ProviderSetDmaChannelCpuAffinity d’un pilote de fournisseur DMA pour spécifier les affinités processeur des canaux DMA d’un fournisseur DMA. NetDMA appelle ProviderSetDmaChannelCpuAffinity dans le contexte du fonction NetDmaRegisterProvider.
Étant donné que le nombre réel de canaux DMA n’est pas connu avant le démarrage d’un fournisseur DMA, l’interface NetDMA spécifie les affinités de processeur pour le nombre maximal de canaux. Le fournisseur DMA fournit le nombre maximal de canaux dans le MaxDmaChannelCount membre du NET_DMA_PROVIDER_CHARACTERISTICS structure qu’elle passe à la fonction NetDmaRegisterProvider.
Sur les ordinateurs qui ne prennent pas en charge les plateformes MSI-X, les affinités processeur peuvent être spécifiées pour les contrôleurs de domaine d’interruption, mais pas pour les interruptions. Dans ce cas, l’interface NetDMA spécifie une liste de processeurs possibles pour le DPC d’interruption dans le ProcessorAffinityMask membre du structure NET_DMA_CHANNEL_PARAMETERS.
Sur les ordinateurs qui prennent en charge MSI-X, le pilote du fournisseur DMA peut spécifier des affinités d’interruption lors de la gestion du IRP_MN_FILTER_RESOURCE_REQUIREMENTS IRP.
NetDMA appelle ProviderSetDmaChannelCpuAffinity à IRQL = PASSIVE_LEVEL.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Pris en charge pour les pilotes NetDMA 1.0 dans Windows Vista. |
| plateforme cible | Windows |
| d’en-tête | netdma.h (include Netdma.h) |
| IRQL | PASSIVE_LEVEL |