PcNewDmaChannel 함수(portcls.h)

PcNewDmaChannel 함수는 새 DMA 채널 개체를 만듭니다. 이 함수는 사용되지 않습니다. 자세한 내용은 다음 설명을 참조하세요.

구문

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

매개 변수

[out] OutDmaChannel

이 함수에서 만든 DMA 채널 개체에 대한 출력 포인터입니다. 이 매개 변수는 함수가 새로 만든 IDmaChannel 개체에 대한 참조를 출력하는 호출자가 할당한 포인터 변수를 가리킵니다. 이 매개 변수에 유효한 NULL 이 아닌 포인터 값을 지정합니다.

[in, optional] OuterUnknown

개체를 집계해야 하는 개체의 IUnknown 인터페이스에 대한 포인터입니다. 집계가 필요하지 않은 경우 이 매개 변수를 NULL로 설정합니다.

[in] PoolType

개체를 할당할 스토리지 풀의 유형을 지정합니다. POOL_TYPE 열거형 값입니다. 이 매개 변수에 대해 페이지가 없는 풀 형식을 지정합니다.

[in] DeviceDescription

호출자가 DMA 개체를 요청하는 물리적 디바이스에 대한 설명에 대한 포인터입니다. 이 매개 변수는 DEVICE_DESCRIPTION 형식의 구조를 가리킵니다.

[in] DeviceObject

물리적 어댑터 디바이스의 디바이스 개체에 대한 포인터입니다. 이 매개 변수는 DEVICE_OBJECT 형식의 시스템 구조를 가리킵니다.

반환 값

PcNewDmaChannel 은 호출에 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 적절한 오류 코드를 반환합니다.

설명

PcNewDmaChannel 은 사용되지 않습니다. 모든 새 오디오 드라이버의 경우 PcNewDmaChannel 대신 다음 IPortWave Xxx::NewXxxDmaChannel 메서드 중 하나를 사용합니다.

IPortWavePci::NewMasterDmaChannel

IPortWaveCyclic::NewMasterDmaChannel

IPortWaveCyclic::NewSlaveDmaChannel

이전 버전과의 호환성을 위해 PortCls 시스템 드라이버는 PcNewDmaChannel을 계속 지원하며 기존 드라이버는 이 함수를 계속 사용할 수 있습니다.

PoolType 매개 변수를 POOL_TYPE 열거형에 정의된 비페이지 풀 형식 중 하나로 지정합니다. IDmaChannel 인터페이스의 여러 메서드를 IRQL DISPATCH_LEVEL 호출할 수 있으므로 DMA 채널 개체는 페이징된 메모리에 있어야 합니다.

OutDmaChannel 및 OuterUnknown 매개 변수는 COM 개체에 대한 참조 계산 규칙을 따릅니다.

요구 사항

추가 정보

DEVICE_DESCRIPTION

DEVICE_OBJECT

IDmaChannel

POOL_TYPE