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 |