PGET_LINK_POSITION_REGISTER di callback (hdaudio.h)

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

Il tipo di puntatore a funzione per GetLinkPositionRegister una routine viene 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 contesto.

[in] Handle

Handle che identifica il motore DMA. Questo valore dell'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 HD Audio esegue il mapping del registro a un indirizzo virtuale di sistema accessibile al driver della 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.

Codice restituito Descrizione
STATUS_INVALID_HANDLE
Indica che il valore del parametro dell'handle non è valido.

Commenti

Per altre informazioni, vedere Wall Clock and Link Position Registers (Registri di posizione di collegamento e orologio delle pareti).

Requisiti

   
Piattaforma di destinazione Desktop
Intestazione hdaudio.h (includere Hdaudio.h)
IRQL <=DISPATCH_LEVEL

Vedi anche

AllocateCaptureDmaEngine

AllocateRenderDmaEngine

HDAUDIO_BUS_INTERFACE

HDAUDIO_BUS_INTERFACE_BDL

HDAUDIO_BUS_INTERFACE_V2