PGET_DEVICE_INFORMATION fonction de rappel (hdaudio.h)
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 |
|---|---|
|
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 |