Hardware Dev Center

GetLinkPositionRegister routine

The GetLinkPositionRegister routine retrieves a pointer to a DMA engine's link position register.

The function pointer type for a GetLinkPositionRegister routine is defined as:

Syntax


PGET_LINK_POSITION_REGISTER GetLinkPositionRegister;

NTSTATUS GetLinkPositionRegister(
  _In_  PVOID  context,
  _In_  HANDLE handle,
  _Out_ PULONG *position
)
{ ... }

Parameters

context [in]

Specifies the context value from the Context member of the HDAUDIO_BUS_INTERFACE, HDAUDIO_BUS_INTERFACE_V2 or HDAUDIO_BUS_INTERFACE_BDL structure.

handle [in]

Handle that identifies the DMA engine. This handle value was obtained from a previous call to AllocateCaptureDmaEngine or AllocateRenderDmaEngine.

position [out]

Retrieves a pointer to the link position register. This parameter points to a caller-allocated PULONG variable into which the routine writes a pointer to the register. The HD Audio bus driver maps the register to a system virtual address that is accessible to the function driver.

Return value

GetLinkPositionRegister returns STATUS_SUCCESS if the call succeeds. Otherwise, the routine returns an appropriate error code. The following table shows a possible return status code.

Return codeDescription
STATUS_INVALID_HANDLE

Indicates that the handle parameter value is invalid.

 

Remarks

For more information, see Wall Clock and Link Position Registers.

Requirements

Target platform

Desktop

Header

Hdaudio.h (include Hdaudio.h)

IRQL

<=DISPATCH_LEVEL

See also

HDAUDIO_BUS_INTERFACE
HDAUDIO_BUS_INTERFACE_V2
HDAUDIO_BUS_INTERFACE_BDL
AllocateCaptureDmaEngine
AllocateRenderDmaEngine

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft