PGET_DEVICE_INFORMATION Rückruffunktion (hdaudio.h)
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 |
---|---|
|
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 GetDeviceInformation
von 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 |