PcNewMiniport, fonction (portcls.h)

Article
08/07/2023

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 miniport doit instancier. Le pilote prend en charge une interface miniport dérivée d’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 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 un 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 Notes qui suit.

Valeur retournée

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 Miniport 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 l’interface IMiniportDMus à utiliser avec l’objet de port IPortDMus .
CLSID_MiniportDriverDMusUARTCapture	Pilote miniport DMusUARTCapture pour le périphérique de capture MPU-401. Expose l’interface IMiniportDMus à utiliser avec l’objet de port IPortDMus .
CLSID_MiniportDriverFmSynth	Pilote miniport FmSynth pour le périphérique de synthèse FM. Expose l’interface IMiniportMidi pour une utilisation avec l’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 UART miniport pour le périphérique de synthèse MPU-401. Expose l’interface IMiniportMidi pour une utilisation avec l’objet de port IPortMidi . Obsolète.

Les deux premiers GUID du tableau précédent sont définis dans le fichier dmusicks.h du fichier dmusicks. 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 MPU-401 MIDI pure. Pour produire du son, cet appareil a besoin d’un module audio MIDI externe attaché à celui-ci.

Le pilote miniport DMusUARTCapture entre des données MIDI à partir d’un périphérique de capture avec une interface MPU-401 pure.

Le pilote miniport FMSynth génère des données MIDI vers un appareil de synthèse qui implémente la synthèse FM de type 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 le synthé FM doivent utiliser le GUID CLSID_MiniportDriverFmSynthWithVol à la place. Dans Windows Server SP1 et versions ultérieures, le pilote miniport FMSynth 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 sur-ensemble de ses fonctionnalités.

Microsoft fournit le code source pour les pilotes miniportS DMusUART et FMSynth, qui peut 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. Examinez les exemples de pilotes audio dans le Kit de pilotes Windows (WDK).

Consultez Création de sous-appareils Pour plus d’informations sur la création de pilotes de port et de miniport pour les sous-appareils.

Le paramètre OutMiniport suit les conventions de comptage de références pour les objets COM.

Configuration requise

Condition requise	Valeur
Client minimal 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érieur.
Plateforme cible	Universal
En-tête	portcls.h (include Portcls.h)
Bibliothèque	Portcls.lib
IRQL	PASSIVE_LEVEL

Voir aussi