PGET_LINK_POSITION_REGISTER función de devolución de llamada (hdaudio.h)

Artículo
02/26/2024

La GetLinkPositionRegister rutina recupera un puntero al registro de posición de vínculo de un motor DMA.

El tipo de puntero de función para una GetLinkPositionRegister rutina se define de la siguiente manera.

Sintaxis

PGET_LINK_POSITION_REGISTER PgetLinkPositionRegister;

NTSTATUS PgetLinkPositionRegister(
  [in]  PVOID _context,
  [in]  HANDLE Handle,
  [out] PULONG *Position
)
{...}

Parámetros

[in] _context

Especifica el valor de contexto del miembro Context del HDAUDIO_BUS_INTERFACE, HDAUDIO_BUS_INTERFACE_V2 o HDAUDIO_BUS_INTERFACE_BDL estructura.

[in] Handle

Identificador que identifica el motor DMA. Este valor de identificador se obtuvo de una llamada anterior a AllocateCaptureDmaEngine o AllocateRenderDmaEngine.

[out] Position

Recupera un puntero al registro de posición del vínculo. Este parámetro apunta a una variable PULONG asignada por el autor de la llamada en la que la rutina escribe un puntero en el registro. El controlador de HD Audio Bus asigna el registro a una dirección virtual del sistema a la que se puede acceder al controlador de función.

Valor devuelto

GetLinkPositionRegister devuelve STATUS_SUCCESS si la llamada se realiza correctamente. De lo contrario, la rutina devuelve un código de error adecuado. En la tabla siguiente se muestra un posible código de estado de retorno.