PGET_LINK_POSITION_REGISTER funzione di callback (hdaudio.h)

Articolo
02/29/2024

La GetLinkPositionRegister routine recupera un puntatore al registro di posizione del collegamento di un motore DMA.

Il tipo di puntatore a funzione per una GetLinkPositionRegister routine è definito come segue.

Sintassi

PGET_LINK_POSITION_REGISTER PgetLinkPositionRegister;

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

Parametri

[in] _context

Specifica il valore di contesto dal membro Context della struttura HDAUDIO_BUS_INTERFACE, HDAUDIO_BUS_INTERFACE_V2 o HDAUDIO_BUS_INTERFACE_BDL .

[in] Handle

Handle che identifica il motore DMA. Questo valore handle è stato ottenuto da una chiamata precedente a AllocateCaptureDmaEngine o AllocateRenderDmaEngine.

[out] Position

Recupera un puntatore al registro della posizione del collegamento. Questo parametro punta a una variabile PULONG allocata dal chiamante in cui la routine scrive un puntatore nel registro. Il driver del bus audio HD esegue il mapping del registro a un indirizzo virtuale di sistema accessibile al driver di funzione.

Valore restituito

GetLinkPositionRegister restituisce STATUS_SUCCESS se la chiamata ha esito positivo. In caso contrario, la routine restituisce un codice di errore appropriato. Nella tabella seguente viene illustrato un possibile codice di stato restituito.