функция обратного вызова 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, если вызов завершается успешно. В противном случае подпрограмма возвращает соответствующий код ошибки. В следующей таблице показан возможный код состояния возврата.

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

Комментарии

Дополнительные сведения см. в разделе "Стенные часы" и "Регистры положения связи".

Требования

   
Целевая платформа Рабочий стол
Заголовок hdaudio.h (include Hdaudio.h)
IRQL <=DISPATCH_LEVEL

См. также

AllocateCaptureDmaEngine

AllocateRenderDmaEngine

HDAUDIO_BUS_INTERFACE

HDAUDIO_BUS_INTERFACE_BDL

HDAUDIO_BUS_INTERFACE_V2