PGET_LINK_POSITION_REGISTER Rückruffunktion (hdaudio.h)
Die GetLinkPositionRegister Routine ruft einen Zeiger auf das Linkpositionsregister einer DMA-Engine 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 der HDAUDIO_BUS_INTERFACE-, HDAUDIO_BUS_INTERFACE_V2 - oder HDAUDIO_BUS_INTERFACE_BDL-Struktur an.
[in] Handle
Handle, das die DMA-Engine identifiziert. Dieser Handle-Wert wurde aus einem vorherigen Aufruf von AllocateCaptureDmaEngine oder AllocateRenderDmaEngine abgerufen.
[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 Audio-Bustreiber ordnet das Register einer virtuellen Systemadresse zu, auf die der Funktionstreiber zugreifen kann.
Rückgabewert
GetLinkPositionRegister gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich ist. Andernfalls gibt die Routine einen entsprechenden Fehlercode zurück. Die folgende Tabelle zeigt eine mögliche Rückgabe status Code.
| Rückgabecode | Beschreibung |
|---|---|
|
Gibt an, dass der Wert des Handle-Parameters ungültig ist. |
Hinweise
Weitere Informationen finden Sie unter Wanduhr und Linkpositionsregister.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | hdaudio.h (einschließlich Hdaudio.h) |
| IRQL | <=DISPATCH_LEVEL |