PGET_LINK_POSITION_REGISTER fonction de rappel (hdaudio.h)

Article
02/26/2024

La GetLinkPositionRegister routine récupère un pointeur vers le registre de position de lien d’un moteur DMA.

Le type de pointeur de fonction pour une GetLinkPositionRegister routine est défini comme suit.

Syntaxe

PGET_LINK_POSITION_REGISTER PgetLinkPositionRegister;

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

Paramètres

[in] _context

Spécifie la valeur de contexte du membre Context de la structure HDAUDIO_BUS_INTERFACE, HDAUDIO_BUS_INTERFACE_V2 ou HDAUDIO_BUS_INTERFACE_BDL .

[in] Handle

Handle qui identifie le moteur DMA. Cette valeur de handle a été obtenue à partir d’un appel précédent à AllocateCaptureDmaEngine ou AllocateRenderDmaEngine.

[out] Position

Récupère un pointeur vers le registre de position de lien. Ce paramètre pointe vers une variable PULONG allouée à l’appelant dans laquelle la routine écrit un pointeur vers le registre. Le pilote de bus HD Audio mappe le registre à une adresse virtuelle système accessible au pilote de fonction.

Valeur retournée

GetLinkPositionRegister retourne STATUS_SUCCESS si l’appel réussit. Sinon, la routine retourne un code d’erreur approprié. Le tableau suivant montre un retour possible status code.