Función PcNewDmaChannel (portcls.h)

La función PcNewDmaChannel crea un nuevo objeto de canal DMA. Esta función está obsoleta; para obtener más información, vea los comentarios siguientes.

Sintaxis

PORTCLASSAPI NTSTATUS PcNewDmaChannel(
  [out]          PDMACHANNEL         *OutDmaChannel,
  [in, optional] PUNKNOWN            OuterUnknown,
  [in]           POOL_TYPE           PoolType,
  [in]           PDEVICE_DESCRIPTION DeviceDescription,
  [in]           PDEVICE_OBJECT      DeviceObject
);

Parámetros

[out] OutDmaChannel

Puntero de salida para el objeto DMA-channel creado por esta función. Este parámetro apunta a una variable de puntero asignada por el autor de la llamada en la que la función genera una referencia al objeto IDmaChannel recién creado. Especifique un valor de punteroNULL válido que no sea null para este parámetro.

[in, optional] OuterUnknown

Puntero a la interfaz IUnknown de un objeto que necesita agregar el objeto. A menos que se requiera la agregación, establezca este parámetro en null.

[in] PoolType

Especifica el tipo de grupo de almacenamiento desde el que se va a asignar el objeto. Se trata de un valor de enumeración POOL_TYPE. Especifique un tipo de grupo no paginado para este parámetro.

[in] DeviceDescription

Puntero a una descripción del dispositivo físico para el que el autor de la llamada solicita un objeto DMA. Este parámetro apunta a una estructura de tipo DEVICE_DESCRIPTION.

[in] DeviceObject

Puntero al objeto de dispositivo para el dispositivo adaptador físico. Este parámetro apunta a una estructura del sistema de tipo DEVICE_OBJECT.

Valor devuelto

PcNewDmaChannel devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado.

Observaciones

PcNewDmaChannel está obsoleto. Para todos los nuevos controladores de audio, use uno de los siguientes métodos IPortWave Xxx::NewXxxDmaChannel en lugar de PcNewDmaChannel:

IPortWavePci::NewMasterDmaChannel

IPortWaveCíclico::NewMasterDmaChannel

IPortWaveCíclico::NewSlaveDmaChannel

Por motivos de compatibilidad con versiones anteriores, el controlador del sistema PortCls seguirá admitiendo PcNewDmaChannel, y los controladores existentes pueden seguir usando esta función.

Especifique el parámetro PoolType para que sea uno de los tipos de grupo no paginados definidos en la enumeración POOL_TYPE. El objeto DMA-channel no debe residir en la memoria paginada porque se pueden llamar a varios de los métodos de la interfaz IDmaChannel desde IRQL DISPATCH_LEVEL.

Los parámetros OutDmaChannel y OuterUnknown siguen las convenciones de recuento de referencias de para objetos COM.

Nota

Microsoft admite un entorno diverso e inclusivo. Este artículo contiene referencias a la terminología que la guía de estilo de Microsoft para la comunicación sin sesgos reconoce como excluyente. La palabra o frase se usa en este artículo para la coherencia porque aparece actualmente en el software. Cuando el software se actualiza para quitar el idioma, este artículo se actualizará para que esté en alineación.

Requisitos

Requisito	Valor
cliente mínimo admitido	Obsoleto. Para todos los nuevos controladores de audio, use un método IPortWaveXxx::NewXxxDmaChannel en su lugar. El controlador del sistema PortCls implementa la función PcNewDmaChannel en Microsoft Windows 98/Me y en los sistemas operativos Windows 2000 y versiones posteriores.
de la plataforma de destino de	Universal
encabezado de	portcls.h (incluya Portcls.h)
biblioteca de	Portcls.lib
irQL	PASSIVE_LEVEL

Consulte también

DEVICE_DESCRIPTION

DEVICE_OBJECT

IDmaChannel

POOL_TYPE