функция обратного вызова PGET_LINK_POSITION_REGISTER (hdaudio.h)
Программа 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. Это значение дескриптора было получено из предыдущего вызова AllocateCaptureDmaEngine или AllocateRenderDmaEngine.
[out] Position
Извлекает указатель на регистр позиции ссылки. Этот параметр указывает на выделенную абонентом переменную PULONG, в которую подпрограмма записывает указатель на регистр. Драйвер аудиошины HD сопоставляет регистрацию с системным виртуальным адресом, доступным драйверу функции.
Возвращаемое значение
GetLinkPositionRegister возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае подпрограмма возвращает соответствующий код ошибки. В следующей таблице показан возможный код состояния возврата.
| Возвращаемый код | Описание |
|---|---|
|
Указывает, что значение параметра дескриптором недопустимо. |
Замечания
Дополнительные сведения см. в разделе Wall Clock and Link Position Registers.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | hdaudio.h (include Hdaudio.h) |
| IRQL | <=DISPATCH_LEVEL |