PGET_LINK_POSITION_REGISTER Rückruffunktion (hdaudio.h)

Artikel
02/26/2024

Die GetLinkPositionRegister Routine ruft einen Zeiger auf das Linkpositionsregister einer DMA-Engine ab.

Der Funktionszeigertyp für eine GetLinkPositionRegister Routine wird wie folgt definiert.

Syntax

PGET_LINK_POSITION_REGISTER PgetLinkPositionRegister;

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

Parameter

[in] _context

Gibt den Kontextwert aus dem Context-Member der HDAUDIO_BUS_INTERFACE-, HDAUDIO_BUS_INTERFACE_V2 - oder HDAUDIO_BUS_INTERFACE_BDL-Struktur an.

[in] Handle

Handle, das die DMA-Engine identifiziert. Dieser Handle-Wert wurde aus einem vorherigen Aufruf von AllocateCaptureDmaEngine oder AllocateRenderDmaEngine abgerufen.

[out] Position

Ruft einen Zeiger auf das Linkpositionsregister ab. Dieser Parameter verweist auf eine vom Aufrufer zugewiesene PULONG-Variable, in die die Routine einen Zeiger auf das Register schreibt. Der HD Audio-Bustreiber ordnet das Register einer virtuellen Systemadresse zu, auf die der Funktionstreiber zugreifen kann.

Rückgabewert

GetLinkPositionRegister gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich ist. Andernfalls gibt die Routine einen entsprechenden Fehlercode zurück. Die folgende Tabelle zeigt eine mögliche Rückgabe status Code.