PGET_DEVICE_INFORMATION Rückruffunktion (hdaudio.h)

  • Artikel

Die GetDeviceInformation Routine ruft Informationen zum HD-Audiocontrollergerät ab.

Der Funktionszeigertyp für eine GetDeviceInformation Routine ist wie folgt definiert.

Syntax

PGET_DEVICE_INFORMATION PgetDeviceInformation;

NTSTATUS PgetDeviceInformation(
  [in]      PVOID _context,
  [in, out] PHDAUDIO_DEVICE_INFORMATION DeviceInformation
)
{...}

Parameter

[in] _context

Gibt den Kontextwert aus dem Kontextelement der HDAUDIO_BUS_INTERFACE oder der HDAUDIO_BUS_INTERFACE_V2-Struktur an.

[in, out] DeviceInformation

Ruft Informationen zum HD-Audiocontrollergerät ab. Dieser Parameter verweist auf eine vom Aufrufer zugewiesene HDAUDIO_DEVICE_INFORMATION Struktur, in die die Routine die Geräteinformationen schreibt.

Rückgabewert

GetDeviceInformation gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich ist. Andernfalls gibt die Routine einen geeigneten Fehlercode zurück. Die folgende Tabelle zeigt eine mögliche Rückgabe status Code.

Rückgabecode Beschreibung
STATUS_BUFFER_TOO_SMALL
 Gibt an, dass die größe, die am Anfang des puffers deviceInformation angegeben wurde, zu klein ist.

Hinweise

Diese Routine ruft geräteabhängige Informationen ab, die statisch sind, d. h. die Informationen ändern sich im Laufe der Zeit nicht dynamisch.

Der deviceInformation-Parameter ist ein Zeiger auf einen Puffer, der eine HDAUDIO_DEVICE_INFORMATION-Struktur enthält, in die die Routine Informationen über den HD-Audiocontroller schreibt. Vor dem Aufrufen GetDeviceInformationvon ordnet der Aufrufer den Puffer zu und schreibt die Größe des Puffers in Bytes in den Size-Member am Anfang des Puffers.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile hdaudio.h (hdaudio.h einschließen)
IRQL PASSIVE_LEVEL

Weitere Informationen

HDAUDIO_BUS_INTERFACE

HDAUDIO_BUS_INTERFACE_V2

HDAUDIO_DEVICE_INFORMATION