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.