PcRegisterSubdevice, fonction (portcls.h)
La fonction PcRegisterSubdevice inscrit un sous-appareil pour le rendre disponible pour une utilisation par les clients.
Syntaxe
PORTCLASSAPI NTSTATUS PcRegisterSubdevice(
[in] PDEVICE_OBJECT DeviceObject,
[in] PWSTR Name,
[in] PUNKNOWN Unknown
);
Paramètres
[in] DeviceObject
Pointeur vers l’objet de périphérique du pilote d’adaptateur. Il s’agit d’une structure système de type DEVICE_OBJECT.
[in] Name
Pointeur vers une chaîne Unicode terminée par null qui spécifie le nom du sous-appareil. La mémoire tampon de chaîne vers laquelle pointe le paramètre Name doit rester valide pendant la durée de vie de l’objet d’appareil. La chaîne contient un nom court qui distingue le sous-appareil de tout autre sous-appareil inscrit sur le même appareil. Chacun des sous-appareils de l’appareil doit avoir un nom unique.
[in] Unknown
Pointeur vers l’interface IPort de l’objet pilote de port lié au sous-appareil.
Valeur retournée
PcRegisterSubdevice retourne STATUS_SUCCESS si l’appel a réussi. Sinon, il retourne un code d’erreur approprié.
Remarques
La fonction inscrit l’interface de périphérique instance pour un objet de filtre qui représente un sous-appareil sur une carte audio. Le gestionnaire d’E/S ajoute la chaîne spécifiée par le paramètre Name à la chaîne de référence qu’il utilise pour identifier le instance. La chaîne de référence modifiée est utile pour distinguer les sous-appareils de la carte audio. Pour plus d’informations sur les chaînes de référence, consultez IoRegisterDeviceInterface.
Pour plus d’informations sur le rôle de la fonction PcRegisterSubdevice dans l’inscription d’un sous-appareil, consultez Création de sous-appareil.
Un pilote d’adaptateur peut appeler la méthode IUnregisterSubdevice ::UnregisterSubdevice pour supprimer l’inscription d’une connexion physique inscrite par un appel précédent à PcRegisterSubdevice. Pour plus d’informations, consultez Sous-appareils audio dynamiques.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Le pilote système PortCls implémente la fonction PcRegisterSubdevice dans Microsoft Windows 98/Me et dans les systèmes d’exploitation Windows 2000 et ultérieurs. |
| Plateforme cible | Universal |
| En-tête | portcls.h (include Portcls.h) |
| Bibliothèque | Portcls.lib |
| IRQL | PASSIVE_LEVEL |