DMA_CHANNEL_ALLOCATE_HANDLER回呼函式 (netdma.h)
在 Windows 8 和更新版本中。
語法
DMA_CHANNEL_ALLOCATE_HANDLER DmaChannelAllocateHandler;
NTSTATUS DmaChannelAllocateHandler(
[in] PVOID ProviderContext,
[in] PNET_DMA_CHANNEL_PARAMETERS ChannelParameters,
[in] PVOID NetDmaChannelHandle,
[out] PVOID *pProviderChannelContext
)
{...}
參數
[in] ProviderContext
識別 DMA 提供者內容區域的指標。 DMA 提供者驅動程式會在呼叫 中將此句柄傳遞至 NetDMA 介面 NetDmaRegisterProvider 函 式。
[in] ChannelParameters
的指標 NET_DMA_CHANNEL_PARAMETERS 結構，定義 DMA 通道的組態參數。
[in] NetDmaChannelHandle
識別 DMA 通道的句柄。 提供者驅動程式會將此句柄傳遞至 NetDmaXxx 函式，以識別 DMA 通道。
[out] pProviderChannelContext
值的指標，這個值是 DMA 通道之 DMA 提供者內容區域的指標。 DMA 提供者驅動程式會先配置此內容區域，再從 ProviderAllocateDmaChannel 傳回。 NetDMA 會將內容區域指標傳遞至需要提供者通道內容的 ProviderXxx 函式。
傳回值
ProviderAllocateDmaChannel 會傳回下列其中一個狀態值：
| 傳回碼 | Description |
|---|---|
|
作業已成功完成。 |
|
作業失敗，因為資源不足。 |
|
作業因未指定的原因而失敗。 |
備註
NetDMA 介面會呼叫 DMA 提供者驅動程式的 ProviderAllocateDmaChannel 函式來配置 DMA 通道。 NetDMA 介面會先呼叫 ProviderAllocateDmaChannel ，再使用 DMA 通道。
DMA 提供者驅動程式會嘗試使用中斷 CPU 親和性來配置 DMA 通道，其符合 ProcessorAffinityMask 成員中指定的位。 NET_DMA_CHANNEL_PARAMETERSChannelParameters 參數的結構。 如果不支援 MSI-X 或 MSI-X，但無法使用具有相符中斷 CPU 親和性的 DMA 通道，DMA 提供者驅動程式會配置任何可用的 DMA 通道，並呼叫 KeSetTargetProcessorDpc 例程來設定中斷 DPC 的目標 CPU，以符合其中一個指定的同質遮罩位。
DMA 提供者一律會將它與 DMA 通道中斷 DPC 相關聯的 CPU 號碼傳回至 NET_DMA_CHANNEL_PARAMETERS 結構的 CpuNumber 成員中的 NetDMA 介面。
DMA 提供者驅動程式會在 ProviderAllocateDmaChannel 的 pProviderChannelContext 參數上，提供驅動程式配置內容資訊的區塊指標。 此內容區域會儲存 DMA 通道的相關信息。 NetDMA 介面會將後續呼叫中的內容信息傳遞至需要 DMA 通道內容的 ProviderXxx 函式。
當 NetDMA 介面呼叫 ProviderAllocateDmaChannel 時，它會在 NetDmaChannelHandle 參數提供句柄。 DMA 提供者驅動程式會在與 DMA 通道相關聯的 NetDmaXxx 函式後續呼叫中使用這個句柄。
NetDMA 介面會呼叫 ProviderFreeDmaChannel 函式，以釋放先前配置的 DMA 通道。
NetDMA 會在 IRQL <= DISPATCH_LEVEL呼叫 ProviderAllocateDmaChannel。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista 中 NetDMA 1.0 驅動程序支援。 |
| 目標平台 | Windows |
| 標頭 | netdma.h (包含 Netdma.h) |
| IRQL | <= DISPATCH_LEVEL |