PGET_DEVICE_INFORMATION fonction de rappel (hdaudio.h)

  • Article

La GetDeviceInformation routine récupère des informations sur le périphérique de contrôleur audio HD.

Le type de pointeur de fonction pour une GetDeviceInformation routine est défini comme suit.

Syntaxe

PGET_DEVICE_INFORMATION PgetDeviceInformation;

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

Paramètres

[in] _context

Spécifie la valeur de contexte du membre Context du HDAUDIO_BUS_INTERFACE ou de la structure HDAUDIO_BUS_INTERFACE_V2 .

[in, out] DeviceInformation

Récupère des informations sur le périphérique de contrôleur audio HD. Ce paramètre pointe vers une structure de HDAUDIO_DEVICE_INFORMATION allouée à l’appelant dans laquelle la routine écrit les informations de l’appareil.

Valeur retournée

GetDeviceInformation retourne STATUS_SUCCESS si l’appel réussit. Sinon, la routine retourne un code d’erreur approprié. Le tableau suivant montre un retour possible status code.

Code de retour Description
STATUS_BUFFER_TOO_SMALL
 Indique que la taille spécifiée au début de la mémoire tampon deviceInformation est trop petite.

Remarques

Cette routine récupère des informations statiques dépendantes de l’appareil, c’est-à-dire que les informations ne changent pas dynamiquement au fil du temps.

Le paramètre deviceInformation est un pointeur vers une mémoire tampon qui contient une structure de HDAUDIO_DEVICE_INFORMATION dans laquelle la routine écrit des informations sur le contrôleur audio HD. Avant d’appeler GetDeviceInformation, l’appelant alloue la mémoire tampon et écrit la taille de la mémoire tampon en octets dans le membre Size au début de la mémoire tampon.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête hdaudio.h (inclure Hdaudio.h)
IRQL PASSIVE_LEVEL

Voir aussi

HDAUDIO_BUS_INTERFACE

HDAUDIO_BUS_INTERFACE_V2

HDAUDIO_DEVICE_INFORMATION