Funzione PcNewMiniport (portcls.h)
La funzione PcNewMiniport crea un'istanza di uno dei driver miniport forniti dal sistema integrati nel driver di sistema PortCls, portcls.sys. Un ID classe specifica quale di questi driver miniport creare un'istanza. Il driver supporta un'interfaccia miniport derivata da IMiniport.
Sintassi
PORTCLASSAPI NTSTATUS PcNewMiniport(
[out] PMINIPORT *OutMiniPort,
[in] REFCLSID ClassID
);
Parametri
[out] OutMiniPort
Puntatore di output per l'oggetto miniport-driver creato da questa funzione. Questo parametro punta a una variabile puntatore allocata dal chiamante in cui la funzione restituisce un riferimento all'oggetto IMiniport appena creato. Questo oggetto è un'istanza del driver miniport specificato dal parametro ClassId . Specificare un valore di puntatore non NULL valido per questo parametro.
[in] ClassID
Specifica l'interfaccia miniport richiesta. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.
Valore restituito
PcNewMiniport restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato.
Commenti
È possibile creare un'istanza dei driver miniport forniti dal sistema per UART MPU-401 e sintetizzatori OPL3 chiamando PcNewMiniport Questi sono driver miniport predefiniti forniti con il driver di sistema portcls.sys. I driver miniport che fanno parte del driver adattatore di un fornitore non vengono creati in questo modo.
Il parametro ClassId può essere impostato su uno dei GUID nella tabella seguente.
| GUID | driver System-Supplied |
|---|---|
| CLSID_MiniportDriverDMusUART | Driver miniport DMusUART per il dispositivo synth MPU-401. Espone l'interfaccia IMiniportDMus da utilizzare con l'oggetto porta IPortDMus . |
| CLSID_MiniportDriverDMusUARTCapture | Driver miniport DMusUARTCapture per il dispositivo di acquisizione MPU-401. Espone l'interfaccia IMiniportDMus da utilizzare con l'oggetto porta IPortDMus . |
| CLSID_MiniportDriverFmSynth | Driver miniport FmSynth per il dispositivo synth FM. Espone l'interfaccia IMiniportMidi da usare con l'oggetto porta IPortMidi . |
| CLSID_MiniportDriverFmSynthWithVol | Uguale alla voce precedente, ad eccezione del fatto che il driver supporta anche un nodo del volume. |
| CLSID_MiniportDriverUart | Driver miniport UART per il dispositivo synth MPU-401. Espone l'interfaccia IMiniportMidi da usare con l'oggetto porta IPortMidi . Obsoleta. |
I primi due GUID nella tabella precedente sono definiti nel file di intestazione dmusicks.h; gli ultimi tre sono definiti in portcls.h.
Il driver miniport DMusUART restituisce dati MIDI in un dispositivo synth con un'interfaccia MIDI MPU-401 pura. Per produrre audio, questo dispositivo necessita di un modulo audio MIDI esterno collegato.
Il driver miniport DMusUARTCapture inserisce dati MIDI da un dispositivo di acquisizione con un'interfaccia MPU-401 pura.
Il driver miniport FMSynth restituisce dati MIDI in un dispositivo synth che implementa la sintesi FM in stile OPL3. Il GUID CLSID_MiniportDriverFmSynth è appropriato per la maggior parte dei dispositivi synth FM. Tuttavia, i dispositivi come Windows Sound System che non forniscono un controllo del volume hardware dopo il synth FM devono usare invece il GUID CLSID_MiniportDriverFmSynthWithVol . In Windows Server SP1 e versioni successive, il driver miniport FMSynth è disponibile solo nelle versioni a 32 bit del sistema operativo.
Il driver miniport UART è obsoleto. Il codice del driver del nuovo adattatore deve usare il driver miniport DMusUART, che sostituisce UART e implementa un superset delle relative funzionalità.
Microsoft fornisce il codice sorgente per i driver miniport DMusUART e FMSynth, che possono fungere da punto di partenza per i fornitori di hardware che potrebbero dover estendere questi driver per gestire funzionalità aggiuntive del dispositivo. Esaminare i driver audio di esempio in Windows Driver Kit (WDK).
Per altre informazioni sulla creazione di driver di porta e miniport per i sottodispositivi, vedere Creazione di sottodispositivi .
Il parametro OutMiniport segue le convenzioni di conteggio dei riferimenti per gli oggetti COM.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Il driver di sistema PortCls implementa la funzione PcNewMiniport in Microsoft Windows 98/Me e nei sistemi operativi Windows 2000 e versioni successive. |
| Piattaforma di destinazione | Universale |
| Intestazione | portcls.h (include Portcls.h) |
| Libreria | Portcls.lib |
| IRQL | PASSIVE_LEVEL |