PFREE_ADAPTER_OBJECT コールバック関数 (wdm.h)

[アーティクル]
08/08/2023

FreeAdapterObject ルーチンは、ドライバーがすべての DMA 操作を完了した後、指定したアダプターオブジェクトを解放します。

構文

PFREE_ADAPTER_OBJECT PfreeAdapterObject;

void PfreeAdapterObject(
  [in] PDMA_ADAPTER DmaAdapter,
  [in] IO_ALLOCATION_ACTION AllocationAction
)
{...}

パラメーター

[in] DmaAdapter

DMA_ADAPTER構造体へのポインター。この構造体は、解放されるアダプターオブジェクトです。このオブジェクトは、ドライバーのバスマスター DMA デバイスまたはシステム DMA チャネルを表します。呼び出し元は、 IoGetDmaAdapter ルーチンの以前の呼び出しからこのポインターを取得しました。

[in] AllocationAction

呼び出し元のドライバーが要求する割り当て解除の種類。このパラメーターを IO_ALLOCATION_ACTION 列挙値に設定します。詳細については、「解説」を参照してください。

戻り値

なし

解説

FreeAdapterObject は、名前で直接呼び出すことができるシステムルーチンではありません。このルーチンは、 DMA_OPERATIONS 構造体で返されるアドレスからのポインターによってのみ呼び出すことができます。ドライバーは、DeviceDescription パラメーターの Version メンバーを DEVICE_DESCRIPTION_VERSION3 に設定して IoGetDmaAdapter を呼び出すことによって、このルーチンのアドレスを取得します。 IoGetDmaAdapter が NULL を返す場合、ルーチンはプラットフォームで使用できません。

AllocationAction = DeallocateObject の場合、FreeAdapterObject 呼び出しによってアダプターオブジェクトが解放され、このオブジェクトに割り当てられるマップレジスタが解放されます。

AllocationAction = DeallocateObjectKeepRegisters の場合、FreeAdapterObject 呼び出しはアダプターオブジェクトを解放しますが、マップレジスタは解放しません。この場合、ドライバーは FreeMapRegisters ルーチンを呼び出して、割り当てられたマップレジスタを明示的に解放する必要があります。

AllocationAction = KeepObject の場合、FreeAdapterObject 呼び出しは無効です。

FreeAdapterObject を使用すると、 AllocateAdapterChannelEx、 GetScatterGatherListEx、および BuildScatterGatherListEx ルーチンの呼び出しによって割り当てられた DMA リソースの割り当てを解除できます。ドライバーがこれらのルーチンのいずれかを同期的に呼び出す場合、 ExecutionRoutine パラメーターは省略可能であり、省略できます。この場合、ドライバーは、呼び出しによって割り当てられたアダプターオブジェクトとマップレジスタを使用できます。ドライバーが DMA 転送を開始した後、ドライバーは FreeAdapterObject を呼び出してアダプターオブジェクトの割り当てを解除し、必要に応じてマップを登録できます。

FreeAdapterChannel ルーチンは、FreeAdapterObject に似ています。 FreeAdapterChannel は 、アダプターオブジェクトと割り当てられたマップレジスタを常に解放します。この動作は、AllocationAction = DeallocateObject の場合、FreeAdapterObject の動作と似ています。

要件

要件	値
サポートされている最小のクライアント	Windows 8以降で使用できます。
対象プラットフォーム	デスクトップ
Header	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
IRQL	<= DISPATCH_LEVEL