Freigeben über


Abrufen eines HDAUDIO_BUS_INTERFACE_BDL DDI-Objekts

Wie bereits erläutert, ruft der Funktionstreiber für einen Audio- oder Modemcodec einen gezählten Verweis auf ein Objekt mit einem HD Audio DDI ab, indem ein IRP_MN_QUERY_INTERFACE IOCTL an den HD Audio-Bustreiber gesendet wird.

Die folgende Tabelle zeigt die Eingabeparameterwerte, die der Funktionstreiber in das IOCTL schreibt, um eine HDAUDIO_BUS_INTERFACE_BDL-Struktur und ein Kontextobjekt für die Version des HD Audio DDI abzurufen, die diese Struktur definiert.

Parameter Wert

CONST GUID *InterfaceType

GUID_HDAUDIO_BUS_INTERFACE_BDL

USHORT-Größe

sizeof(HDAUDIO_BUS_INTERFACE_BDL)

USHORT-Version

0x0100

PINTERFACE-Schnittstelle

Zeiger auf HDAUDIO_BUS_INTERFACE_BDL Struktur

PVOID-SchnittstelleSpecificData

NULL

Der Funktionstreiber weist den Speicher für die HDAUDIO_BUS_INTERFACE_BDL-Struktur zu und enthält einen Zeiger auf diese Struktur in der IOCTL. In der vorherigen Tabelle wird der Zeiger auf die HDAUDIO_BUS_INTERFACE_BDL-Struktur in den Typ PINTERFACE umgewandelt, bei dem es sich um einen Zeiger auf eine Struktur vom Typ INTERFACE handelt. Die Namen und Typen der ersten fünf Member von HDAUDIO_BUS_INTERFACE_BDL entsprechen denen der fünf Member von INTERFACE. HDAUDIO_BUS_INTERFACE_BDL enthält zusätzliche Member, die Funktionszeiger auf die DDI-Routinen sind. Als Reaktion auf den Empfang des IOCTL vom Funktionstreiber füllt der HD Audio-Bustreiber die gesamte HDAUDIO_BUS_INTERFACE_BDL-Struktur aus.

Die folgende Tabelle zeigt die Werte, die der HD Audio-Bustreiber in die ersten fünf Member der HDAUDIO_BUS_INTERFACE_BDL-Struktur schreibt.

Member Wert

USHORT-Größe

sizeof(HDAUDIO_BUS_INTERFACE_BDL)

USHORT-Version

0x0100

PVOID-Kontext

Kontextinformationen, die als erster Aufrufparameter an jede DDI-Routine übergeben werden müssen

PINTERFACE_REFERENCE InterfaceReference

Zeiger auf eine Routine, die die Verweisanzahl des Kontextobjekts erhöht

PINTERFACE_DEREFERENCE InterfaceDereference

Zeiger auf eine Routine, die die Verweisanzahl des Kontextobjekts verringert

In der obigen Tabelle verweist das Context-Element auf ein Kontextobjekt, das Informationen enthält, die für die jeweilige instance der HDAUDIO_BUS_INTERFACE_BDL Version des DDI spezifisch sind, die der Client von der IOCTL erhält. Wie bereits erläutert, muss der Clientfunktionstreiber beim Aufrufen einer der Routinen im DDI immer den Context-Zeigerwert als ersten Aufrufparameter angeben.