KsRecalculateStackDepth 関数 (ks.h)

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

KsRecalculateStackDepth 関数は、ターゲットデバイスを設定したすべてのオブジェクトに基づいて、基になるデバイスオブジェクトに必要な最大スタック深度を再計算します (KsSetTargetDeviceObject 関数を使用して、基になるデバイスオブジェクトのオブジェクトリストに追加されています)。 KsSetDevicePnpAndBaseObject を使用して基になるデバイスヘッダーに PnP デバイスオブジェクトが設定されている場合、そのデバイスはスタックの最大深度を計算するときにも考慮されます。

構文

KSDDKAPI VOID KsRecalculateStackDepth(
  [in] KSDEVICE_HEADER Header,
  [in] BOOLEAN         ReuseStackLocation
);

パラメーター

[in] Header

KsAllocateDeviceHeader によって以前に割り当てられたヘッダーを指します。

[in] ReuseStackLocation

TRUE に設定すると、IRP が転送されるときに現在のスタックの場所が再利用されます。つまり、IRP を転送するときに、このオブジェクトは独自のスタックの場所を必要とせず、追加の場所は最大スタックサイズに追加されません。 FALSE に設定すると、計算されるスタックサイズは 1 ずつインクリメントされます。 Pnp オブジェクトスタックが設定されている場合、再利用パラメーターもそのスタックに適用されます。 KsDefaultDispatchPnp は常に現在のスタックの場所を再利用します。スタックの最小深さは 1 です。

戻り値

なし

解説

KsRecalculateStackDepth 関数は、KsSetDevicePnpAndBaseObject がこのデバイスヘッダーで呼び出され、スタックの深さが再計算される基本オブジェクトを割り当てたと想定しています。

この関数を使用すると、このデバイスに割り当てられた IRP に転送できる十分なスタックの場所を確保することで、オブジェクトを介して IRP を転送できます。スタックの深さは、デバイスが Stop 状態から遷移したときにストリーミングデバイスで再計算する必要があります。また、リソースを節約するためにオブジェクトが解放されたときに再計算することもできます。