IPortClsStreamResourceManager::RemoveStreamResource 메서드(portcls.h)

  • 아티클

RemoveStreamResource는 기존 스트림 리소스를 제거합니다. RemoveStreamResource 메서드는 오디오 waveRT 미니포트 드라이버에서만 사용할 수 있습니다.

구문

NTSTATUS RemoveStreamResource(
  PCSTREAMRESOURCE ResourceHandle
);

매개 변수

ResourceHandle

PCSTREAMRESOURCE – PcAddStreamResource에서 반환된 리소스 핸들입니다. 자세한 내용은 PcAddStreamResource를 참조하세요.

반환 값

이 메서드는 다음을 포함하는 NTSTATUS를 반환합니다.

  • STATUS_SUCCESS – 드라이버가 지정된 PDO의 리소스를 등록할 수 있었습니다.
  • STATUS_INVALID_PARAMETER – 드라이버가 다른 오류 상태 인스턴스에 대한 특정 사례 외에 다른 매개 변수가 유효하지 않은 경우를 발견하면 이 오류를 반환합니다.

추가 표준 상태 코드가 반환될 수 있습니다.

설명

결함이 없는 작업을 보장하려면 오디오 드라이버가 스트리밍 리소스를 portcls에 등록해야 합니다. 이렇게 하면 OS가 리소스를 관리하여 오디오 스트리밍과 다른 하위 시스템 간의 간섭을 방지할 수 있습니다. Stream 리소스는 오디오 드라이버가 오디오 스트림을 처리하거나 오디오 데이터 흐름을 확인하는 데 사용하는 모든 리소스입니다.

오디오 드라이버는 이전에 등록된 리소스를 제거해야 합니다. 드라이버는 다음 시스템 작업의 결과로 리소스 등록을 취소할 수 있습니다.

  • I/O 리소스가 변경되면 디바이스의 균형을 다시 조정합니다.
  • 리소스가 제거되거나 생성되면 디바이스 전원 전환(D0<- ->Dx) 예를 들어 Dx로 전환할 때 인터럽트 연결이 끊어지고 D0으로 다시 이동하여 다시 연결될 수 있습니다.
  • 처리 중지, 서프라이즈 제거, 플러그 앤 플레이 이벤트를 제거합니다.
  • 연결된 오디오 엔드포인트가 사라지면 예를 들어 엔드포인트의 데이터 스트림을 처리하기 위해 스레드가 만들어지고 엔드포인트가 제거되는 경우입니다. 이 경우 드라이버는 스레드 스트림 리소스를 제거해야 합니다.

오디오 드라이버는 이 호출을 수행할 때 리소스가 유효한지 확인해야 합니다.

요구 사항

요구 사항 값
헤더 portcls.h
IRQL PASSIVE_LEVEL

추가 정보

IPortClsStreamResourceManager