NdisAllocateIoWorkItem 関数 (ndis.h)

[アーティクル]
02/26/2024

NDIS ドライバーは、作業項目を割り当てるために NdisAllocateIoWorkItem 関数を呼び出します。詳細については、「 NDIS I/O 作業項目」を参照してください。

構文

NDIS_HANDLE NdisAllocateIoWorkItem(
  [in] NDIS_HANDLE NdisObjectHandle
);

パラメーター

[in] NdisObjectHandle

デバイスオブジェクトまたはドライバーオブジェクトに関連付けられている NDIS オブジェクトのハンドル。

戻り値

NdisAllocateIoWorkItem が作業項目を正常に割り当てた場合、作業項目へのハンドルが返されます。失敗した場合、 NdisAllocateIoWorkItem はNULL を返します。

注釈

NDIS ミニポートドライバーは、2 つのハンドルのいずれか NdisAllocateIoWorkItem を 渡す: ミニポートドライバーが呼び出されたときに NDIS が返すミニポートドライバーハンドルまたは NDIS がミニポートドライバーのハンドルに渡したアダプターハンドル NdisMRegisterMiniportDriver。

NDIS フィルタードライバーは、NdisFRegisterFilterDriver というフィルタードライバーが返したときに NDIS が返したフィルタードライバーハンドルを NdisAllocateIoWorkItem に渡すことができます。

NDIS ミニポートドライバーとフィルタードライバーは、NdisRegisterDeviceEx ドライバーが呼び出されたときに NDIS が返した NDIS デバイスハンドル NdisAllocateIoWorkItem を渡すこともできます。 NdisAllocateIoWorkItem は、ハンドルに関連付けられているデバイスオブジェクトまたはドライバーオブジェクトを取得し、デバイスオブジェクトまたはドライバーオブジェクトを IoAllocateWorkItem 関数に渡します。

メモ NDIS は、デバイスオブジェクトまたはドライバーオブジェクトにプロトコルドライバーを関連付けないため、プロトコルドライバーは NdisAllocateIoWorkItem を使用できません。

NDIS ドライバーは、作業項目のキューに NdisQueueIoWorkItem 関数を呼び出します。ドライバーが NdisQueueIoWorkItem を呼び出した後、NDIS は IRQL = PASSIVE_LEVELでドライバー指定のコールバック関数を呼び出します。これにより、現在の関数をすぐに終了し、ドライバーが後で低い IRQL で作業できるようにすることで、システムのパフォーマンスを向上させることができます。

NDIS ドライバーは、 NdisFreeIoWorkItem 関数を呼び出して、 NdisAllocateIoWorkItem が割り当てた作業項目に関連付けられているリソースを解放する必要があります。

ドライバーは、 NdisQueueIoWorkItem に渡されるコールバックルーチンで NdisFreeIoWorkItem を呼び出すことができます。

ミニポートドライバーが NdisAllocateIoWorkItem を呼び出したときに NDIS が MiniportInitializeEx に渡したハンドルを使用している場合は、ドライバーの MiniportHaltEx 関数の呼び出しの前または呼び出しで作業項目を解放する必要があります。

ドライバーが NdisAllocateIoWorkItem を呼び出したときに NdisMRegisterMiniportDriver が返したハンドルをミニポートドライバーが使用した場合、ドライバーはドライバーのアンロード前に作業項目を解放する必要があります。

一般に、ドライバーは、ドライバーがアンロードする前に作業項目を解放する必要があります。

要件

要件	値
サポートされている最小のクライアント	NDIS 6.0 以降でサポートされています。
対象プラットフォーム	ユニバーサル
Header	ndis.h (Ndis.h を含む)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL
DDI コンプライアンス規則	Init_NdisAllocateIoWorkItem(ndis)、 Irql_Miscellaneous_Function(ndis)