KsPinSubmitFrame 函数 (ks.h)

如果通过调用 KsPinRegisterFrameReturnCallback 将引脚置于注入模式, 则 KsPinSubmitFrame 函数会将帧直接提交到传输线路中。

语法

KSDDKAPI NTSTATUS KsPinSubmitFrame(
  [in]           PKSPIN           Pin,
  [in, optional] PVOID            Data,
  [in, optional] ULONG            Size,
  [in, optional] PKSSTREAM_HEADER StreamHeader,
  [in, optional] PVOID            Context
);

参数

[in] Pin

指向要提交帧的 KSPIN 结构的指针。

[in, optional] Data

指向帧缓冲区的指针。 当且仅当 Size 等于 0 时,此值应为 NULL。 可选。

[in, optional] Size

数据字段指向的帧缓冲区的大小(以字节为单位)。 如果 “数据” 字段为 NULL,请将此参数设置为零。 可选。

[in, optional] StreamHeader

指向 KSSTREAM_HEADER 结构的指针。 如果提供了此参数,则会复制流标头。 可选。

[in, optional] Context

指向调用方分配的缓冲区的指针。 AVStream 提供此指针,指向通过调用 KsPinRegisterFrameReturnCallback 注册的帧返回回调。 可选。

返回值

如果帧提交成功,则返回STATUS_SUCCESS。 否则返回相应的错误代码。

要求

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

另请参阅

KsPinRegisterFrameReturnCallback

KsPinSubmitFrameMdl