функция обратного вызова 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

Задает значение контекста из элемента Contextструктуры HDAUDIO_BUS_INTERFACE, HDAUDIO_BUS_INTERFACE_V2 или HDAUDIO_BUS_INTERFACE_BDL .

[in] Handle

Дескриптор, идентифицирующий подсистему DMA. Это значение дескриптора было получено при предыдущем вызове Метода AllocateCaptureDmaEngine или AllocateRenderDmaEngine.

[out] Position

Извлекает указатель на регистр положения ссылки. Этот параметр указывает на выделенную вызывающим объектом переменную PULONG, в которую подпрограмма записывает указатель на регистр. Драйвер шины HD Audio сопоставляет регистр с системным виртуальным адресом, доступным драйверу функции.

Возвращаемое значение

GetLinkPositionRegister возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае подпрограмма возвращает соответствующий код ошибки. В следующей таблице показан возможный код состояния возврата.

Код возврата Описание
STATUS_INVALID_HANDLE
 Указывает, что значение параметра дескриптора недопустимо.

Комментарии

Дополнительные сведения см. в разделе Настенные часы и Регистры позиций ссылок.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть hdaudio.h (включая Hdaudio.h)
IRQL <=DISPATCH_LEVEL

См. также раздел

AllocateCaptureDmaEngine

AllocateRenderDmaEngine

HDAUDIO_BUS_INTERFACE

HDAUDIO_BUS_INTERFACE_BDL

HDAUDIO_BUS_INTERFACE_V2