Compartilhar via


Obtendo um objeto DDI HDAUDIO_BUS_INTERFACE_BDL

Conforme explicado anteriormente, o driver de função de um codec de áudio ou modem obtém uma referência contada a um objeto com uma DDI de áudio HD enviando uma IRP_MN_QUERY_INTERFACE IOCTL para o driver do barramento de áudio HD.

A tabela a seguir mostra os valores de parâmetro de entrada que o driver de função grava no IOCTL para obter uma estrutura HDAUDIO_BUS_INTERFACE_BDL e um objeto de contexto para a versão da DDI de áudio HD que essa estrutura define.

Parâmetro Valor

CONST GUID *InterfaceType

GUID_HDAUDIO_BUS_INTERFACE_BDL

Tamanho do USHORT

sizeof(HDAUDIO_BUS_INTERFACE_BDL)

Versão do USHORT

0x0100

Interface PINTERFACE

Ponteiro para HDAUDIO_BUS_INTERFACE_BDL estrutura

InterfaceSpecificData do PVOID

NULL

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

A tabela a seguir mostra os valores que o driver do barramento de áudio HD grava nos cinco primeiros membros da estrutura HDAUDIO_BUS_INTERFACE_BDL .

Membro Valor

Tamanho do USHORT

sizeof(HDAUDIO_BUS_INTERFACE_BDL)

Versão do USHORT

0x0100

Contexto PVOID

Informações de contexto que precisam ser passadas como o primeiro parâmetro de chamada para cada rotina de DDI

interface PINTERFACE_REFERENCE Reference

Ponteiro para uma rotina que incrementa a contagem de referência do objeto de contexto

PINTERFACE_DEREFERENCE InterfaceDereference

Ponteiro para uma rotina que diminui a contagem de referência do objeto de contexto

Na tabela anterior, o membro Context aponta para um objeto de contexto que contém informações específicas para a instância específica da versão HDAUDIO_BUS_INTERFACE_BDL da DDI que o cliente obtém do IOCTL. Conforme explicado anteriormente, ao chamar qualquer uma das rotinas na DDI, o driver de função do cliente deve sempre especificar o valor do ponteiro contextual como o primeiro parâmetro de chamada.