IDeviceTopology::GetSubunit, méthode (devicetopology.h)

Article
08/23/2023

La méthode GetSubunit obtient la sous-unité spécifiée par un numéro de sous-unité.

Syntaxe

HRESULT GetSubunit(
  [in]  UINT     nIndex,
  [out] ISubunit **ppSubunit
);

Paramètres

[in] nIndex

Numéro de sous-unité. Si une topologie d’appareil contient n sous-unités, les sous-unités sont numérotées de 0 à n– 1. Pour obtenir le nombre de sous-unités dans la topologie de l’appareil, appelez la méthode IDeviceTopology::GetSubunitCount .

[out] ppSubunit

Pointeur vers une variable pointeur dans laquelle la méthode écrit l’adresse de l’interface ISubunit de l’objet sous-unité. Grâce à cette méthode, l’appelant obtient une référence comptée à l’interface. L’appelant est chargé de libérer l’interface, lorsqu’elle n’est plus nécessaire, en appelant la méthode Release de l’interface. Si l’appel GetSubunit échoue, *ppSubunit a la valeur NULL.

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.

Code de retour	Description
E_INVALIDARG	Le paramètre nIndex est hors de la plage.
E_POINTER	Le pointeur ppSubunit a la valeur NULL.

Spécifications


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	devicetopology.h

Voir aussi

IDeviceTopology Interface

IDeviceTopology::GetSubunitCount

ISubunit Interface

Partager via