IPortWaveCyclic::NewMasterDmaChannel 메서드(portcls.h)
NewMasterDmaChannel 메서드는 버스 마스터 DMA 채널의 새 인스턴스를 만듭니다.
통사론
NTSTATUS NewMasterDmaChannel(
[out] PDMACHANNEL *DmaChannel,
[in] PUNKNOWN OuterUnknown,
[in, optional] PRESOURCELIST ResourceList,
[in] ULONG MaximumLength,
[in] BOOLEAN Dma32BitAddresses,
[in] BOOLEAN Dma64BitAddresses,
[in] DMA_WIDTH DmaWidth,
[in] DMA_SPEED DmaSpeed
);
매개 변수
[out] DmaChannel
메서드가 새 IDmaChannel 개체에 대한 포인터를 쓰는 호출자 할당 포인터 변수에 대한 포인터입니다. 이 매개 변수에 대해 유효한NULL 포인터 값을 지정합니다.
[in] OuterUnknown
DMA 채널 개체를 집계해야 하는 개체의 IUnknown 인터페이스에 대한 포인터입니다. 이 매개 변수는 선택 사항입니다. 집계가 필요하지 않은 경우 이 매개 변수를 NULL지정합니다.
[in, optional] ResourceList
IResourceList 개체인 미니포트 드라이버의 리소스 목록에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL지정할 수 있습니다.
NewMasterDmaChannel 메서드는 현재 이 매개 변수를 사용하지 않습니다.
[in] MaximumLength
이 채널과 연결될 순환 DMA 버퍼의 최대 길이(바이트)입니다.
[in] Dma32BitAddresses
32비트 주소의 사용을 지정합니다.
[in] Dma64BitAddresses
64비트 주소의 사용을 지정합니다.
[in] DmaWidth
사용되지 않습니다. (DMA_WIDTH)(-1)로 설정합니다.
[in] DmaSpeed
사용되지 않습니다. (DMA_SPEED)(-1)로 설정합니다.
반환 값
NewMasterDmaChannel 호출에 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 메서드가 적절한 오류 코드를 반환합니다.
발언
MaximumLength , Dma32BitAddresses, Dma64BitAddresses, DmaWidth및 DmaSpeed매개 변수는 이름이 같은 DEVICE_DESCRIPTION 구조체의 멤버와 비슷합니다.
버스 마스터링 DMA 하드웨어가 내장된 WaveCyclic 디바이스를 마스터 디바이스이라고 합니다. 반면, 하위 디바이스 DMA 하드웨어가 부족하며 시스템 DMA 컨트롤러를 사용하여 필요한 데이터 전송을 수행해야 합니다.
NewMasterDmaChannel 메서드는 마스터 디바이스에 대한 DMA 채널 개체를 만듭니다. 하위 디바이스에 대한 DMA 채널 개체를 만들려면 IPortWaveCyclic::NewSlaveDmaChannel 메서드를 대신 호출합니다. 마스터 및 하위 디바이스에 대한 자세한 내용은 IDmaChannel 및 IDmaChannelSlave참조하세요.
DmaChannel, OuterUnknown및 ResourceList 매개 변수는 COM 개체에 대한참조 계산 규칙을 따릅니다.
메모
Microsoft는 다양하고 포괄적인 환경을 지원합니다. 이 문서에는 바이어스 없는 통신 대한 Microsoft 스타일 가이드에서 제외로 인식하는 용어에 대한 참조가 포함되어 있습니다. 단어 또는 구는 현재 소프트웨어에 표시되므로 일관성을 위해 이 문서에서 사용됩니다. 언어를 제거하도록 소프트웨어가 업데이트되면 이 문서가 정렬되도록 업데이트됩니다.
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | 보편적 |
| 헤더 | portcls.h(Portcls.h 포함) |
| IRQL | PASSIVE_LEVEL |