KsPinGetAvailableByteCount 函数 (ks.h)

项目
05/23/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 用于输出引脚。

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

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

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

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

要求

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