KsStreamPointerGetIrp 関数 (ks.h)

KsStreamPointerGetIrp 関数は、指定されたストリーム ポインターによって参照されるフレームに関連付けられている IRP を返します。

構文

KSDDKAPI PIRP KsStreamPointerGetIrp(
  [in]            PKSSTREAM_POINTER StreamPointer,
  [out, optional] PBOOLEAN          FirstFrameInIrp,
  [out, optional] PBOOLEAN          LastFrameInIrp
);

パラメーター

[in] StreamPointer

関連付けられた IRP が返されるフレームを参照する KSSTREAM_POINTER 構造体へのポインター。

[out, optional] FirstFrameInIrp

StreamPointer によって参照されるフレームが返される IRP の最初のフレームである場合は、呼び出し元が指定した BOOLEAN 値を TRUE に設定し、返されない場合は FALSE へのポインター。 NULL の場合、AVStream はこの条件をテストしません。

[out, optional] LastFrameInIrp

ストリーム ポインターによって参照されるフレームが、返された IRP の最後のフレームである場合は TRUE に設定され、返されない場合は FALSE に設定された呼び出し元から提供される BOOLEAN 値へのポインター。 NULL の場合、AVStream はこの条件をテストしません。

戻り値

KsStreamPointerGetIrp は、指定されたストリーム ポインターによって参照されるフレームに関連付けられている IRP へのポインターを返すか、 NULL を返します。 戻り値 NULL は、ストリーム ポインターがロックされていないことを示します。

注釈

KsStreamPointerGetIrp を使用して、返された IRP に含まれる最初のフレームまたは最後のフレームを StreamPointer が参照しているかどうかを判断することもできます。

KsStreamPointerGetIrp を正常に実行するには、StreamPointer をロックする必要があります。 ロック解除されたストリーム ポインターを使用してこの関数を呼び出そうとすると、 NULL 戻り値が返されます。

AVStream でこれらの値を入力するには、呼び出し時に FirstFrameInIrp と/LastFrameInIrp を NULL 以外にする必要があります。

「Stream ポインター」も参照してください。

要件

こちらもご覧ください

KsStreamPointerGetMdl

KsStreamPointerLock