Bagikan melalui

Metode IPortClsStreamResourceManager::RemoveStreamResource (portcls.h)

  • Artikel

RemoveStreamResource menghapus sumber daya aliran yang ada. Metode RemoveStreamResource hanya dapat digunakan oleh driver miniport waveRT audio.

Sintaks

NTSTATUS RemoveStreamResource(
  PCSTREAMRESOURCE ResourceHandle
);

Parameter

ResourceHandle

PCSTREAMRESOURCE– Handel sumber daya yang dikembalikan oleh PcAddStreamResource. Untuk informasi selengkapnya, lihat PcAddStreamResource.

Nilai kembali

Metode ini mengembalikan NTSTATUS yang berisi:

  • STATUS_SUCCESS – Driver dapat mendaftarkan sumber daya PDO yang ditentukan.
  • STATUS_INVALID_PARAMETER – Driver mengembalikan kesalahan ini jika menemukan parameter lain yang tidak valid, selain dari kasus tertentu untuk instans status kesalahan lainnya.

Kode status standar tambahan dapat dikembalikan.

Keterangan

Untuk membantu memastikan operasi bebas kesalahan, driver audio harus mendaftarkan sumber daya streaming mereka dengan portcl. Ini memungkinkan OS mengelola sumber daya untuk menghindari gangguan antara streaming audio dan subsistem lainnya. Stream sumber daya adalah sumber daya apa pun yang digunakan oleh driver audio untuk memproses aliran audio atau memastikan aliran data audio.

Driver audio harus menghapus sumber daya yang terdaftar sebelumnya. Driver dapat membatalkan pendaftaran sumber daya sebagai akibat dari aktivitas sistem berikut:

  • Keseimbangan ulang perangkat saat sumber daya I/O berubah.
  • Transisi daya perangkat (D0<- ->Dx) saat sumber daya dihancurkan atau dibuat. Misalnya interupsi mungkin terputus saat masuk ke Dx dan disambungkan kembali dengan pindah kembali ke D0.
  • Saat memproses peristiwa berhenti, hapus kejutan, hapus peristiwa plug and play.
  • Saat titik akhir audio terkait hilang. Misalnya jika utas dibuat untuk menangani aliran data titik akhir dan titik akhir dihapus. Dalam hal ini, driver harus menghapus sumber daya aliran utas.

Driver audio harus memastikan sumber daya valid saat melakukan panggilan ini.

Persyaratan

Persyaratan Nilai
Header portcls.h
IRQL PASSIVE_LEVEL

Lihat juga

IPortClsStreamResourceManager