GetLinkPositionRegister 例程检索指向 DMA 引擎的链接位置寄存器的指针。
GetLinkPositionRegister 例程的函数指针类型定义如下。
语法
PGET_LINK_POSITION_REGISTER PgetLinkPositionRegister;
NTSTATUS PgetLinkPositionRegister(
[in] PVOID _context,
[in] HANDLE Handle,
[out] PULONG *Position
)
{...}
参数
[in] _context
指定 HDAUDIO_BUS_INTERFACE、HDAUDIO_BUS_INTERFACE_V2 或 HDAUDIO_BUS_INTERFACE_BDL 结构 上下文 成员中的上下文值。
[in] Handle
标识 DMA 引擎的句柄。 此句柄值是从上一次调用 <
[out] Position
检索指向链接位置寄存器的指针。 此参数指向调用方分配的 PULONG 变量，该变量将例程写入寄存器的指针。 HD 音频总线驱动程序将寄存器映射到可供函数驱动程序访问的系统虚拟地址。
返回值
如果调用成功，则 GetLinkPositionRegister 返回STATUS_SUCCESS。 否则，例程将返回适当的错误代码。 下表显示了可能的返回状态代码。
| 返回代码 | 描述 |
|---|---|
|
指示 句柄 参数值无效。 |
言论
有关详细信息，请参阅 时钟和链接位置寄存器。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | hdaudio.h （包括 Hdaudio.h） |
| IRQL | <=DISPATCH_LEVEL |