IPort ::GetDeviceProperty, méthode (portcls.h)
La méthode GetDeviceProperty fournit un accès simplifié aux propriétés d’appareil contenues dans le Registre pour les appareils Plug-and-Play.
Syntaxe
NTSTATUS GetDeviceProperty(
DEVICE_REGISTRY_PROPERTY DeviceProperty,
ULONG BufferLength,
PVOID PropertyBuffer,
PULONG ResultLength
);
Paramètres
DeviceProperty
Identifie la propriété d’appareil spécifique demandée par l’appelant. Les valeurs valides pour ce paramètre sont identiques à celles définies pour le paramètre DeviceProperty de l’appel IoGetDeviceProperty.
BufferLength
Spécifie la longueur en octets de la mémoire tampon qui doit recevoir les informations demandées.
PropertyBuffer
Pointeur vers la mémoire tampon de propriété. Ce paramètre pointe vers une mémoire tampon allouée par l’appelant dans laquelle la méthode écrit les informations de propriété demandées. La mémoire tampon doit être suffisamment grande pour contenir le nombre d’octets spécifiés dans BufferLength.
ResultLength
Pointeur de sortie vers la longueur des données retournées. Ce paramètre pointe vers une variable ULONG allouée par l’appelant dans laquelle la méthode écrit un nombre d’octets réellement écrits dans la mémoire tampon PropertyBuffer. Si la mémoire tampon est trop petite pour contenir les informations, toutefois, la méthode génère plutôt la taille de mémoire tampon requise.
Valeur de retour
Cette méthode retourne NTSTATUS qui contient STATUS_SUCCESS si l’appel a réussi. Sinon, la méthode retourne un code d’erreur approprié. Si la mémoire tampon de propriété fournie par l’appelant est trop petite, la méthode retourne STATUS_BUFFER_TOO_SMALL et génère la taille nécessaire dans ReturnLength.
Remarques
Cette méthode récupère les propriétés de l’appareil de la carte audio. Il est similaire en opération à la fonction PcGetDeviceProperty, sauf qu’il récupère automatiquement les propriétés de l’appareil de la carte audio plutôt que de demander à un objet d’appareil de spécifier explicitement un appareil cible.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | portcls.h |
| IRQL | PASSIVE_LEVEL |