Funzione PcNewDmaChannel (portcls.h)

Articolo
08/07/2023

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 di puntatore non NULL valido 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.

Commenti

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 PcNewDmaChannel e 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 da IRQL DISPATCH_LEVEL.

I parametri OutDmaChannel ed 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 le comunicazioni senza distorsioni 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 in modo che sia allineato.

Requisiti

Requisito	Valore
Client minimo supportato	Obsoleta. 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

Vedi anche

Condividi tramite