PGET_DEVICE_INFORMATION Rückruffunktion (hdaudio.h)
Die GetDeviceInformation Routine ruft Informationen zum HD-Audiocontrollergerät ab.
Der Funktionszeigertyp für eine GetDeviceInformation Routine wird 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 Context Member des 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 einen möglichen Rückgabestatuscode.
| Rückgabecode | Beschreibung |
|---|---|
|
Gibt an, dass die am Anfang des deviceInformation Puffer angegebene Größe zu klein ist. |
Bemerkungen
Diese Routine ruft geräteabhängige Informationen ab, die statisch sind, d. h. die Informationen werden im Laufe der Zeit nicht dynamisch geändert.
Der parameter deviceInformation ist ein Zeiger auf einen Puffer, der eine HDAUDIO_DEVICE_INFORMATION Struktur enthält, in die die Routine Informationen zum HD-Audiocontroller schreibt. Vor dem Aufrufen von GetDeviceInformationweist der Aufrufer den Puffer zu und schreibt die Größe des Puffers in Byte in das Size Member am Anfang des Puffers.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | hdaudio.h (einschließlich Hdaudio.h) |
| IRQL- | PASSIVE_LEVEL |