Obtenção de um objeto DDI HDAUDIO_BUS_INTERFACE

A tabela a seguir mostra os valores dos parâmetros de entrada que o driver de função grava no IOCTL IRP_MN_QUERY_INTERFACE para obter uma estrutura HDAUDIO_BUS_INTERFACE e um objeto de contexto para a versão do HD Audio DDI que essa estrutura define.

O driver de função aloca armazenamento para a estrutura HDAUDIO_BUS_INTERFACE e inclui um ponteiro para essa estrutura no IOCTL. Na tabela anterior, o ponteiro para a estrutura HDAUDIO_BUS_INTERFACE é convertido para o tipo PINTERFACE, que é um ponteiro para uma estrutura do tipo INTERFACE. Os nomes e tipos dos cinco primeiros membros do HDAUDIO_BUS_INTERFACE correspondem aos dos cinco membros do INTERFACE. HDAUDIO_BUS_INTERFACE contém membros adicionais que são ponteiros de função para as rotinas DDI. Em resposta ao recebimento do IOCTL do driver de função, o driver do barramento HD Audio preenche toda a estrutura HDAUDIO_BUS_INTERFACE.

A tabela a seguir mostra os valores que o driver de barramento HD Audio grava nos primeiros cinco membros da estrutura HDAUDIO_BUS_INTERFACE.

Na tabela anterior, o membro Context aponta para um objeto de contexto que contém informações específicas para a instância particular da DDI de áudio HD básica que o cliente obtém do IOCTL. Ao chamar qualquer uma das rotinas do DDI, o driver de função do cliente deve sempre especificar o valor do ponteiro Context como o primeiro parâmetro da chamada. As informações de contexto são opacas para o cliente. O driver de barramento HD Audio cria um objeto de contexto diferente para cada cliente. Quando o objeto de contexto não é mais necessário, o cliente libera o objeto de contexto chamando o InterfaceDereference rotina mostrada na tabela anterior. Se necessário, um cliente pode criar referências adicionais ao objeto chamando o InterfaceReference rotina, mas o cliente é responsável por liberar essas referências quando não precisar mais delas.