PcAddStreamResource 함수(portcls.h)
PcAddStreamResource는 스트림 리소스를 추가합니다. 인터럽트 및 드라이버 소유 스레드라는 두 가지 유형의 스트림 리소스가 지원됩니다. PcAddStreamResource는 오디오 스트림과 연결된 인터럽트/스레드가 있는 오디오가 아닌 WaveRT 미니포트 드라이버에서 호출할 수 있습니다. 오디오 WaveRT 미니포트 드라이버에서도 호출할 수 있습니다.
구문
PORTCLASSAPI NTSTATUS PcAddStreamResource(
[in] PDEVICE_OBJECT PhysicalDeviceObject,
[in] PVOID ResourceSet,
[in] PPCSTREAMRESOURCE_DESCRIPTOR ResourceDescriptor,
[out] PCSTREAMRESOURCE *ResourceHandle
);
매개 변수
[in] PhysicalDeviceObject
PDEVICE_OBJECT - 이 리소스를 사용하는 디바이스 스택의 PDO입니다.
[in] ResourceSet
PVOID - 나중에 사용할 수 있도록 예약되며 NULL로 설정됩니다. 현재는 디바이스 범위 리소스만 지원됩니다.
[in] ResourceDescriptor
PPCSTREAMRESOURCE_DESCRIPTOR - 추가할 리소스입니다. 자세한 내용은 PCSTREAMRESOURCE_DESCRIPTOR 참조하세요.
[out] ResourceHandle
PCSTREAMRESOURCE* - 리소스 핸들을 보유할 위치입니다. 자세한 내용은 PcRemoveStreamResource를 참조하세요.
반환 값
STATUS_SUCCESS – 드라이버가 지정된 PDO의 리소스를 등록할 수 있었습니다.
STATUS_INVALID_PARAMETER – 드라이버가 다른 오류 상태 인스턴스에 대한 특정 사례 외에 다른 매개 변수가 유효하지 않은 것으로 확인되면 이 오류를 반환합니다.
추가 표준 상태 코드가 반환될 수 있습니다.
설명
결함이 없는 작업을 보장하려면 오디오 드라이버가 스트리밍 리소스를 portcls에 등록해야 합니다. 이를 통해 OS는 오디오 스트리밍과 다른 하위 시스템 간의 간섭을 방지하기 위해 리소스를 관리할 수 있습니다.
Stream 리소스는 오디오 드라이버가 오디오 스트림을 처리하거나 오디오 데이터 흐름을 보장하는 데 사용하는 모든 리소스입니다.
모든 오디오 드라이버는 오디오 클래스 드라이버에 스트림 리소스를 등록해야 합니다. 드라이버는 인터럽트, 드라이버 소유 스레드 및 다른 오디오 스택의 리소스에 대한 종속성(예: 병렬 오디오 드라이버 스택)과 같은 리소스 유형을 등록합니다. 자세한 내용은 PCSTREAMRESOURCE_DESCRIPTOR 정의를 참조하세요.
오디오 드라이버는 이 호출을 수행할 때 리소스가 유효한지 확인해야 합니다.
Windows 10만 실행되는 오디오 드라이버는 PcAddStreamResource 및 PcRemoveStreamResource를 사용할 수 있습니다. 이전 버전의 Windows에서도 실행해야 하는 Audio waveRT 미니포트 드라이버의 경우 AddStreamResource 및 RemoveStreamResource를 사용합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 |
| 지원되는 최소 서버 | Windows Server 2016 |
| 대상 플랫폼 | Windows |
| 헤더 | portcls.h |
| 라이브러리 | Portcls.lib |
| DLL | 해당 없음 |
| IRQL | PASSIVE_LEVEL |