PGET_LINK_POSITION_REGISTER funzione di callback (hdaudio.h)
La routine GetLinkPositionRegister recupera un puntatore al registro della posizione del collegamento di un motore DMA.
Il tipo di puntatore di funzione per una routine GetLinkPositionRegister è 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 del 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 di 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 al 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.
| Codice restituito | Descrizione |
|---|---|
|
Indica che l'handle valore del parametro non è valido. |
Osservazioni
Per altre informazioni, vedere Wall Clock e Link Position Registers.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | hdaudio.h (include Hdaudio.h) |
| IRQL | <=DISPATCH_LEVEL |