KsPinGetAvailableByteCount 函数 (ks.h)

项目
03/05/2024

KsPinGetAvailableByteCount 例程输出前边缘前的输入数据的字节数和前边缘前面的输出缓冲区的字节数，这两者都用于调用方指定引脚的队列。

语法

KSDDKAPI NTSTATUS KsPinGetAvailableByteCount(
  [in]            PKSPIN Pin,
  [out, optional] PLONG  InputDataBytes,
  [out, optional] PLONG  OutputBufferBytes
);

参数

[in] Pin

指向要为其计算这些队列参数的 KSPIN 结构的指针。

[out, optional] InputDataBytes

指向 LONG 值的指针，其中例程返回前导边缘前的输入数据字节数。如果未请求此值，则调用方将设置为 NULL 。

[out, optional] OutputBufferBytes

指向 LONG 值的指针，其中例程返回前导边缘前的输出缓冲区字节数。如果未请求此值，则调用方将设置为 NULL 。

返回值

如果已检索请求的计数 () ，则返回STATUS_SUCCESS。非结果返回状态指示 Pin 没有关联的队列。

注解

非本地引脚应将 InputDataBytes 用于输入引脚，将 OutputBufferBytes 用于输出引脚。

不保证此调用的结果是安全的，除非在调用时保留处理互斥体，或者调用方在调用例程之前已私下同步。若要进行专用同步，请确保在执行例程时引脚不会从 Acquire 转换到停止。请参阅在 AVStream 中处理互斥体。

另请注意，就地转换可以提供输入和输出计数。

在 Windows XP 和 DirectX 8.0 中，除非筛选器接收的帧已满，否则 InputDataBytes 计数无效。

有关其他信息，请参阅前导和尾随边缘Stream指针。

要求

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