Fonction PcNewMiniport (portcls.h)
La fonction PcNewMiniport crée une instance de l’un des pilotes miniport fournis par le système qui sont intégrés au pilote système PortCls, portcls.sys. Un ID de classe spécifie lequel de ces pilotes miniports à instancier. Le pilote prend en charge une interface miniport dérivée de IMiniport.
Syntaxe
PORTCLASSAPI NTSTATUS PcNewMiniport(
[out] PMINIPORT *OutMiniPort,
[in] REFCLSID ClassID
);
Paramètres
[out] OutMiniPort
Pointeur de sortie pour l’objet miniport-driver créé par cette fonction. Ce paramètre pointe vers une variable de pointeur allouée par l’appelant dans laquelle la fonction génère une référence à l’objet IMiniport nouvellement créé. Cet objet est une instance du pilote miniport spécifié par le paramètre ClassId. Spécifiez une valeur de pointeur non NULL valide pour ce paramètre.
[in] ClassID
Spécifie l’interface miniport demandée. Pour plus d’informations, consultez la section Remarques suivante.
Valeur de retour
PcNewMiniport retourne STATUS_SUCCESS si l’appel a réussi. Sinon, elle retourne un code d’erreur approprié.
Remarques
Les pilotes miniport fournis par le système pour les UART MPU-401 et les synthétiseurs OPL3 peuvent être instanciés en appelant PcNewMiniport Il s’agit de pilotes miniport intégrés fournis avec le pilote système portcls.sys. Les pilotes miniports qui font partie du pilote d’adaptateur d’un fournisseur ne sont pas créés de cette façon.
Le paramètre ClassId peut être défini sur l’un des GUID du tableau suivant.
| GUID | pilote System-Supplied |
|---|---|
| CLSID_MiniportDriverDMusUART | Pilote miniport DMusUART pour le périphérique de synthèse MPU-401. Expose interface IMiniportDMus à utiliser avec objet de port IPortDMus. |
| CLSID_MiniportDriverDMusUARTCapture | Pilote miniport DMusUARTCapture pour le périphérique de capture MPU-401. Expose interface IMiniportDMus à utiliser avec objet de port IPortDMus. |
| CLSID_MiniportDriverFmSynth | Pilote fmSynth miniport pour l’appareil de synthèse FM. Expose interface IMiniportMidi à utiliser avec objet de port IPortMidi. |
| CLSID_MiniportDriverFmSynthWithVol | Identique à l’entrée précédente, sauf que le pilote prend également en charge un nœud de volume. |
| CLSID_MiniportDriverUart | Pilote miniport UART pour l’appareil de synthèse MPU-401. Expose interface IMiniportMidi à utiliser avec objet de port IPortMidi. Obsolète. |
Les deux premiers GUID du tableau précédent sont définis dans le fichier dmusicks.h ; les trois derniers sont définis dans portcls.h.
Le pilote miniport DMusUART génère des données MIDI vers un appareil de synthèse avec une interface MIDI pure MPU-401. Pour produire du son, cet appareil a besoin d’un module audio MIDI externe attaché à celui-ci.
Le pilote miniport DMusUARTCapture entre les données MIDI d’un appareil de capture avec une interface MPU-401 pure.
Le pilote FMSynth miniport génère des données MIDI vers un appareil de synthèse qui implémente la synthèse FM de style OPL3. Le GUID CLSID_MiniportDriverFmSynth convient à la plupart des appareils de synthèse FM. Toutefois, les appareils tels que le système audio Windows qui ne fournissent pas de contrôle de volume matériel après que le synthé FM doit utiliser le GUID CLSID_MiniportDriverFmSynthWithVol à la place. Dans Windows Server SP1 et versions ultérieures, le pilote FMSynth miniport est disponible uniquement dans les versions 32 bits du système d’exploitation.
Le pilote miniport UART est obsolète. Le nouveau code du pilote d’adaptateur doit utiliser le pilote miniport DMusUART, qui remplace UART et implémente un super-ensemble de ses fonctionnalités.
Microsoft fournit le code source pour les pilotes miniport DMusUART et FMSynth, qui peuvent servir de point de départ pour les fournisseurs de matériel qui peuvent avoir besoin d’étendre ces pilotes pour gérer des fonctionnalités d’appareil supplémentaires. Recherchez les exemples de pilotes audio dans le Kit de pilotes Windows (WDK).
Pour plus d’informations sur la création de ports et les pilotes miniport pour les sous-éléments , consultez Création de sous-éléments.
Le paramètre OutMiniport suit les conventions de comptage de référence pour les objets COM.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Le pilote système PortCls implémente la fonction PcNewMiniport dans Microsoft Windows 98/Me et dans les systèmes d’exploitation Windows 2000 et ultérieurs. |
| plateforme cible | Universel |
| d’en-tête | portcls.h (include Portcls.h) |
| bibliothèque | Portcls.lib |
| IRQL | PASSIVE_LEVEL |