Funzione PcNewDmaChannel (portcls.h)
La funzione PcNewDmaChannel crea un nuovo oggetto canale DMA. Questa funzione è obsoleta; per altre informazioni, vedere i commenti seguenti.
Sintassi
PORTCLASSAPI NTSTATUS PcNewDmaChannel(
[out] PDMACHANNEL *OutDmaChannel,
[in, optional] PUNKNOWN OuterUnknown,
[in] POOL_TYPE PoolType,
[in] PDEVICE_DESCRIPTION DeviceDescription,
[in] PDEVICE_OBJECT DeviceObject
);
Parametri
[out] OutDmaChannel
Puntatore di output per l'oggetto canale DMA creato da questa funzione. Questo parametro punta a una variabile puntatore allocata dal chiamante in cui la funzione restituisce un riferimento all'oggetto IDmaChannel appena creato. Specificare un valore valido, nonNULL valore del puntatore per questo parametro.
[in, optional] OuterUnknown
Puntatore all'interfaccia IUnknown di un oggetto che deve aggregare l'oggetto. A meno che non sia necessaria l'aggregazione, impostare questo parametro su NULL.
[in] PoolType
Specifica il tipo di pool di archiviazione da cui deve essere allocato l'oggetto. Si tratta di un valore di enumerazione POOL_TYPE. Specificare un tipo di pool non di paging per questo parametro.
[in] DeviceDescription
Puntatore a una descrizione del dispositivo fisico per il quale il chiamante richiede un oggetto DMA. Questo parametro punta a una struttura di tipo DEVICE_DESCRIPTION.
[in] DeviceObject
Puntatore all'oggetto dispositivo per il dispositivo adattatore fisico. Questo parametro punta a una struttura di sistema di tipo DEVICE_OBJECT.
Valore restituito
PcNewDmaChannel restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato.
Osservazioni
PcNewDmaChannel è obsoleto. Per tutti i nuovi driver audio, usare uno dei metodi IPortWave Xxx::NewXxxDmaChannel al posto di PcNewDmaChannel:
IPortWavePci::NewMasterDmaChannel
IPortWaveCyclic::NewMasterDmaChannel
IPortWaveCyclic::NewSlaveDmaChannel
Per motivi di compatibilità con le versioni precedenti, il driver di sistema PortCls continuerà a supportare PcNewDmaChannele i driver esistenti possono continuare a usare questa funzione.
Specificare il parametro PoolType come uno dei tipi di pool non di paging definiti nell'enumerazione POOL_TYPE. L'oggetto canale DMA non deve risiedere nella memoria di paging perché è possibile chiamare diversi metodi nell'interfaccia IDmaChannel IRQ DISPATCH_LEVEL L.
I parametri OutDmaChannel e OuterUnknown seguono le convenzioni di conteggio dei riferimenti per gli oggetti COM.
Nota
Microsoft supporta un ambiente diversificato e inclusivo. Questo articolo contiene riferimenti alla terminologia riconosciuta dalla guida di stile Microsoft per la comunicazione senza pregiudizi come esclusioni. La parola o la frase viene usata in questo articolo per coerenza perché è attualmente presente nel software. Quando il software viene aggiornato per rimuovere la lingua, questo articolo verrà aggiornato per essere allineato.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Obsoleto. Per tutti i nuovi driver audio, usare invece un metodo IPortWaveXxx::NewXxxDmaChannel. Il driver di sistema PortCls implementa la funzione PcNewDmaChannel 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 |