Получение объекта DDI HDAUDIO_BUS_INTERFACE
В следующей таблице показаны значения входных параметров, которые драйвер функции записывает в IRP_MN_QUERY_INTERFACE IOCTL, чтобы получить структуру HDAUDIO_BUS_INTERFACE и объект контекста для версии HD Audio DDI, определяемой этой структурой.
| Параметр | Значение |
|---|---|
GUID CONST *InterfaceType |
GUID_HDAUDIO_BUS_INTERFACE |
Размер USHORT |
sizeof(HDAUDIO_BUS_INTERFACE) |
Версия USHORT |
0x0100 |
Интерфейс PINTERFACE |
Указатель на структуру HDAUDIO_BUS_INTERFACE |
PvOID InterfaceSpecificData |
NULL |
Драйвер функции выделяет хранилище для структуры HDAUDIO_BUS_INTERFACE и включает указатель на эту структуру в IOCTL. В предыдущей таблице указатель на структуру HDAUDIO_BUS_INTERFACE приводится к типу PINTERFACE, который является указателем на структуру типа INTERFACE. Имена и типы первых пяти элементов HDAUDIO_BUS_INTERFACE совпадают с именами и типами пяти элементов INTERFACE. HDAUDIO_BUS_INTERFACE содержит дополнительные члены, которые являются указателями функций на подпрограммы DDI. В ответ на получение IOCTL от драйвера функции драйвер шины HD Audio заполняет всю структуру HDAUDIO_BUS_INTERFACE .
В следующей таблице показаны значения, которые драйвер шины HD Audio записывает в первые пять элементов структуры HDAUDIO_BUS_INTERFACE .
| Член | Значение |
|---|---|
Размер USHORT |
sizeof(HDAUDIO_BUS_INTERFACE) |
Версия USHORT |
0x0100 |
Контекст PVOID |
Сведения о контексте, которые должны передаваться в качестве первого параметра вызова каждой подпрограмме DDI |
PINTERFACE_REFERENCE InterfaceReference |
Указатель на подпрограмму, которая увеличивает число ссылок объекта контекста |
PINTERFACE_DEREFERENCE InterfaceDereference |
Указатель на подпрограмму, которая уменьшает количество ссылок объекта контекста |
В предыдущей таблице элемент Context указывает на объект контекста, содержащий сведения, относящиеся к конкретному экземпляру базового hd Audio DDI, полученного клиентом из IOCTL. При вызове любой подпрограммы в DDI драйвер функции клиента должен всегда указывать значение указателя контекста в качестве первого параметра вызова. Сведения о контексте непрозрачны для клиента. Драйвер шины HD Audio создает отдельный объект контекста для каждого клиента. Если объект контекста больше не требуется, клиент освобождает объект контекста, вызывая подпрограмму InterfaceDereference , показанную в предыдущей таблице. При необходимости клиент может создать дополнительные ссылки на объект, вызвав подпрограмму InterfaceReference , но клиент отвечает за освобождение этих ссылок, когда они больше не требуются.