PGET_LINK_POSITION_REGISTER Rückruffunktion (hdaudio.h)

Die GetLinkPositionRegister Routine ruft einen Zeiger auf das Verknüpfungspositionsregister eines DMA-Moduls 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 des HDAUDIO_BUS_INTERFACE, HDAUDIO_BUS_INTERFACE_V2 oder HDAUDIO_BUS_INTERFACE_BDL Struktur an.

[in] Handle

Behandeln, das das DMA-Modul identifiziert. Dieser Handlewert wurde aus einem vorherigen Aufruf von AllocateCaptureDmaEngine oder AllocateRenderDmaEngineabgerufen.

[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-Audiobustreiber ordnet das Register einer virtuellen Systemadresse zu, die für den Funktionstreiber zugänglich ist.

Rückgabewert

GetLinkPositionRegister gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich ist. Andernfalls gibt die Routine einen geeigneten Fehlercode zurück. Die folgende Tabelle zeigt einen möglichen Rückgabestatuscode.

Bemerkungen

Weitere Informationen finden Sie unter Wall Clock and Link Position Registers.

Anforderungen

Siehe auch

AllocateCaptureDmaEngine

AllocateRenderDmaEngine

HDAUDIO_BUS_INTERFACE

HDAUDIO_BUS_INTERFACE_BDL

HDAUDIO_BUS_INTERFACE_V2