KsStreamPointerGetIrp 函数 (ks.h)

KsStreamPointerGetIrp 函数返回与给定流指针引用的帧关联的 IRP。

语法

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

参数

[in] StreamPointer

指向 KSSTREAM_POINTER 结构的指针,该结构引用为其返回关联 IRP 的帧。

[out, optional] FirstFrameInIrp

如果 StreamPointer 引用的帧是返回的 IRP 中的第一个帧,则指向调用方提供的 BOOLEAN 值的指针,如果不是,则返回时设置为 TRUE。 如果 为 NULL,则 AVStream 不会测试此条件。

[out, optional] LastFrameInIrp

如果流指针引用的帧是返回的 IRP 中的最后一个帧,则指向调用方提供的 BOOLEAN 值的指针设置为 TRUE ;否则为 FALSE 。 如果 为 NULL,则 AVStream 不会测试此条件。

返回值

KsStreamPointerGetIrp 返回指向与给定流指针引用的帧关联的 IRP 的指针,或返回 NULL。 返回值 NULL 指示流指针未锁定。

注解

KsStreamPointerGetIrp 还可用于确定 StreamPointer 引用返回的 IRP 中包含的第一个和/或最后一个帧。

必须锁定 StreamPointer,KsStreamPointerGetIrp 才能成功执行。 任何使用未锁定流指针调用此函数的尝试都会导致 NULL 返回值。

FirstFrameInIrp /LastFrameInIrp 在调用时必须为非 NULL ,以便 AVStream 填充这些值。

另请参阅Stream指针

要求

要求
最低受支持的客户端 在 Microsoft Windows XP 及更高版本的操作系统以及 DirectX 8.0 及更高版本的 DirectX 中可用。
目标平台 通用
标头 ks.h (包括 Ks.h)
Library Ks.lib
IRQL <=DISPATCH_LEVEL

另请参阅

KsStreamPointerGetMdl

KsStreamPointerLock