função de retorno de chamada PGET_LINK_POSITION_REGISTER (hdaudio.h)

Artigo
02/26/2024

A GetLinkPositionRegister rotina recupera um ponteiro para o registro de posição de vínculo de um mecanismo de DMA.

O tipo de ponteiro de função para uma GetLinkPositionRegister rotina é definido da seguinte maneira.

Sintaxe

PGET_LINK_POSITION_REGISTER PgetLinkPositionRegister;

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

Parâmetros

[in] _context

Especifica o valor de contexto do membro Context da estrutura HDAUDIO_BUS_INTERFACE, HDAUDIO_BUS_INTERFACE_V2 ou HDAUDIO_BUS_INTERFACE_BDL .

[in] Handle

Identificador que identifica o mecanismo de DMA. Esse valor de identificador foi obtido de uma chamada anterior para AllocateCaptureDmaEngine ou AllocateRenderDmaEngine.

[out] Position

Recupera um ponteiro para o registro de posição do link. Esse parâmetro aponta para uma variável PULONG alocada pelo chamador na qual a rotina grava um ponteiro no registro. O driver do barramento de áudio HD mapeia o registro para um endereço virtual do sistema acessível ao driver de função.

Retornar valor

GetLinkPositionRegister retornará STATUS_SUCCESS se a chamada for bem-sucedida. Caso contrário, a rotina retornará um código de erro apropriado. A tabela a seguir mostra um possível retorno status código.