PGET_LINK_POSITION_REGISTER funzione di callback (hdaudio.h)
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.
| Codice restituito | Descrizione |
|---|---|
|
Indica che il valore del parametro handle non è valido. |
Commenti
Per altre informazioni, vedere Wall Clock and Link Position Registers.For more information, see Wall Clock and Link Position Registers.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | hdaudio.h (include Hdaudio.h) |
| IRQL | <=DISPATCH_LEVEL |