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 |
|---|---|
|
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 |