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

추가 정보

PCSTREAMRESOURCE_DESCRIPTOR

PcRemoveStreamResource