NetDmaProviderStop 関数 (netdma.h)

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

メモ NetDMA インターフェイスはサポートされていません

Windows 8以降。

NetDmaProviderStop 関数は、DMA プロバイダーに関連付けられているすべての DMA チャネルが DMA 転送で使用できなくなったことを NetDMA インターフェイスに通知します。

構文

NET_DMA_EXPORT VOID NetDmaProviderStop(
  [in] PVOID NetDmaProviderHandle
);

パラメーター

[in] NetDmaProviderHandle

DMA プロバイダーを識別するハンドル。 DMA プロバイダードライバーは、への呼び出しで NetDMA インターフェイスからこのハンドルを受信しました。 NetDmaRegisterProvider 関数。

戻り値

なし

解説

DMA プロバイダードライバーは 、NetDmaProviderStop 関数を呼び出して、 NetDmaProviderStart 関数を呼び出して開始された DMA エンジンが使用できなくなったことを NetDMA インターフェイスに通知します。

DMA プロバイダードライバーは 、NetDmaDeregisterProvider 関数を呼び出して DMA プロバイダーを登録解除する前に、NetDmaProviderStop を呼び出す必要があります。

DMA プロバイダードライバーは通常、IRP_MN_REMOVE_DEVICEまたはIRP_MN_STOP_DEVICE IRP の処理中に NetDmaProviderStop を呼び出します。

DMA プロバイダードライバーは、DMA プロバイダーを登録した後、DMA プロバイダーを登録解除する前に、アプリケーションで必要な回数だけ NetDmaProviderStop と NetDmaProviderStart を呼び出すことができます。 DMA エンジンが NetDmaProviderStop と呼ばれた後に再起動される場合、DMA プロバイダードライバーは、で新しい属性を指定できます。NetDmaProviderStart の ProviderAttributes パラメーターで構造体をNET_DMA_PROVIDER_ATTRIBUTESします。

NetDMA インターフェイスは、未処理の DMA 操作が完了するまで待機し、割り当てられたすべての DMA チャネルを解放してから 、NetDmaProviderStop 関数から戻ります。

要件

要件	値
サポートされている最小のクライアント	Windows Vista の NetDMA 1.0 ドライバーでサポートされています。
対象プラットフォーム	ユニバーサル
Header	netdma.h (Netdma.h を含む)
IRQL	PASSIVE_LEVEL