KsPinGetAvailableByteCount 函数（ks.h）

项目
02/07/2025

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。不成功的返回状态表示固定没有关联的队列。

言论

非位置引脚应对输入引脚使用 InputDataBytes，OutputBufferBytes 输出引脚。

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

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

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

有关详细信息，请参阅前导和尾随边缘流指针。

要求

要求	价值
最低支持的客户端	Microsoft Windows XP 及更高版本的作系统以及 DirectX 8.0 及更高版本的 DirectX 版本中提供。
目标平台	普遍
标头	ks.h （包括 Ks.h）
库	Ks.lib