KsDeviceGetBusData 函数 （ks.h）
KsDeviceGetBusData 函数从给定 AVStream 设备所在的总线读取数据。
语法
KSDDKAPI ULONG KsDeviceGetBusData(
[in] PKSDEVICE Device,
[in] ULONG DataType,
[in] PVOID Buffer,
[in] ULONG Offset,
[in] ULONG Length
);
参数
[in] Device
指向 KSDEVICE 结构的指针，表示应从总线读取数据的给定 AVStream 设备。
[in] DataType
此参数指示要读取的总线数据类型。 零对应于配置空间。 有关详细信息，请参阅 IRP_MN_READ_CONFIG参考页中 WhichSpace 的讨论。
[in] Buffer
指向接收从总线读取的数据的缓冲区的指针。 长度必须至少与 长度一样大。
[in] Offset
此参数包含 DataType 指定的空间中的字节偏移量， 从中读取数据。
[in] Length
此参数指定要读入 Buffer的字节数。
返回值
KsDeviceGetBusData 返回实际从总线读取的字节数。 如果发生错误，则此值为零。
言论
根据指定设备所在的总线的驱动程序，此函数存在两种可能的行为和限制集。 如果给定的总线驱动程序支持总线接口标准（通常是 PCI），请在 IRQL = PASSIVE_LEVEL 或DISPATCH_LEVEL调用此函数。 在进行此类调用后，KsDeviceGetBusData 返回从请求的空间读取的实际字节数。 但是，如果给定的总线驱动程序不支持总线接口标准，则 AVStream 通过 IoCallDriver与总线驱动程序通信。 请注意，这会将 KsDeviceGetBusData 限制为 IRQL = PASSIVE_LEVEL，并且表示返回值为 0（如果失败）或等于 长度（如果数据获取成功）。
为了确保兼容性，微型驱动程序编写器可能需要将 KsDeviceGetBusData 限制为 IRQL = PASSIVE_LEVEL。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Microsoft Windows XP 及更高版本的作系统以及 DirectX 8.0 及更高版本的 DirectX 版本中提供。 |
| 目标平台 | 普遍 |
| 标头 | ks.h （包括 Ks.h） |
| 库 | Ks.lib |
| IRQL | PASSIVE_LEVEL（请参阅“备注”部分） |