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

A GetLinkPositionRegister rotina recupera um ponteiro para o registro de posição de vínculo de um mecanismo 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 contextual da estrutura HDAUDIO_BUS_INTERFACE, HDAUDIO_BUS_INTERFACE_V2 ou HDAUDIO_BUS_INTERFACE_BDL .

[in] Handle

Identificador que identifica o mecanismo 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 por 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ções.

Valor retornado

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 código de status de retorno.

Código de retorno Descrição
STATUS_INVALID_HANDLE
Indica que o valor do parâmetro de identificador é inválido.

Comentários

Para obter mais informações, consulte Registros de Posição de Wall Clock e Link.

Requisitos

   
Plataforma de Destino Área de Trabalho
Cabeçalho hdaudio.h (inclua Hdaudio.h)
IRQL <=DISPATCH_LEVEL

Confira também

AllocateCaptureDmaEngine

AllocateRenderDmaEngine

HDAUDIO_BUS_INTERFACE

HDAUDIO_BUS_INTERFACE_BDL

HDAUDIO_BUS_INTERFACE_V2