Метод IPortClsStreamResourceManager::RemoveStreamResource (portcls.h)

  • Статья

RemoveStreamResource удаляет существующий ресурс потока. Метод RemoveStreamResource может использоваться только драйверами минипорта audio waveRT.

Синтаксис

NTSTATUS RemoveStreamResource(
  PCSTREAMRESOURCE ResourceHandle
);

Параметры

ResourceHandle

PCSTREAMRESOURCE — дескриптор ресурса, возвращаемый pcAddStreamResource. Дополнительные сведения см. в разделе PcAddStreamResource.

Возвращаемое значение

Этот метод возвращает NTSTATUS, который содержит:

  • STATUS_SUCCESS — драйвер смог зарегистрировать ресурс указанного PDO.
  • STATUS_INVALID_PARAMETER — драйвер возвращает эту ошибку, если он считает какой-либо другой параметр недопустимым, кроме конкретных случаев для других экземпляров состояния ошибки.

Могут возвращаться дополнительные стандартные коды состояния.

Комментарии

Чтобы обеспечить бесперебойную работу, аудиодрайверы должны зарегистрировать свои ресурсы потоковой передачи с помощью portcls. Это позволяет ОС управлять ресурсами, чтобы избежать помех между потоковой передачей звука и другими подсистемами. Stream ресурсы — это любые ресурсы, используемые аудиодрайвером для обработки аудиопотоков или обеспечения потока аудиоданных.

Аудиодрайверы должны удалить ранее зарегистрированный ресурс. Драйверы могут отменить регистрацию ресурса в результате следующих системных действий:

  • Перебалансируйте устройство при изменении ресурсов ввода-вывода.
  • При уничтожении или создании ресурсов происходит смена питания устройства (D0-Dx<>). Например, прерывания могут быть отключены при переходе в Dx и повторно подключены с возвратом к D0.
  • При остановке обработки, неожиданном удалении, удалении событий plug and play.
  • Если связанные конечные точки звука исчезнут. Например, если поток создается для обработки потока данных конечной точки и конечная точка удаляется. В этом случае драйвер должен удалить ресурс потока потока.

Аудиодрайвер должен убедиться, что ресурс действителен при выполнении этого вызова.

Требования

Требование Значение
Заголовок portcls.h
IRQL PASSIVE_LEVEL

См. также раздел

IPortClsStreamResourceManager