PGET_DEVICE_INFORMATION fonction de rappel (hdaudio.h)
La routine GetDeviceInformation récupère des informations sur l’appareil du contrôleur audio HD.
Le type de pointeur de fonction pour une routine GetDeviceInformation 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 l’appareil du contrôleur audio HD. Ce paramètre pointe vers une structure HDAUDIO_DEVICE_INFORMATION allouée par l’appelant dans laquelle la routine écrit les informations de l’appareil.
Valeur de retour
GetDeviceInformation retourne STATUS_SUCCESS si l’appel réussit. Sinon, la routine retourne un code d’erreur approprié. Le tableau suivant montre un code d’état de retour possible.
| Retourner le code | Description |
|---|---|
|
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 les informations dépendantes de l’appareil qui sont statiques, 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 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 Taille au début de la mémoire tampon.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | hdaudio.h (include Hdaudio.h) |
| IRQL | PASSIVE_LEVEL |