(portcls.h) IPortWaveRTStream 介面

IPortWaveRTStream Windows Vista 和更新版本的作業系統都支援介面,它是數據流特定的介面,可提供協助程式方法供 WaveRT 迷你埠驅動程式使用。 迷你埠驅動程式會呼叫 方法來執行音訊數據迴圈緩衝區的配置和對應。 WaveRT 埠驅動程序會實作這個介面。 埠驅動程式會 IPortWaveRTStream 為其建立的每個迷你埠驅動程序數據流物件提供對象參考。 IPortWaveRTStream 繼承自 IUnknown 介面。

音訊數據流會與 WaveRT 篩選器上的每個針腳實例相關聯。 配接器驅動程式會藉由系結 WaveRT 埠和迷你埠驅動程式來形成篩選。 當埠驅動程式呼叫 IMiniportWaveRT::NewStream 方法來建立迷你埠驅動程式數據流物件時,埠驅動程式會將參考當做其中一個 IPortWaveRTStream 方法的呼叫參數傳遞。

若要配置迴圈緩衝區所需的記憶體,迷你埠驅動程序必須呼叫 介面的 IPortWaveRTStreamAllocatePagesForMdl方法或AllocateContiguousPagesForMdl方法。 介面提供其他方法,可對應已配置的頁面、取消對應,也可以釋放它們。

介面中 IPortWaveRTStream 的方法是以執行記憶體描述元清單 (MDL 配置和對應的 MmXxx 核心函式) 類似。 不過,無法使用 MmXxx 函式取代 IPortWaveRTStream 方法。

繼承

IPortWaveRTStream 介面繼承自 IUnknown 介面。 IPortWaveRTStream 也有下列類型的成員:

方法

IPortWaveRTStream 介面具有這些方法。

 
IPortWaveRTStream::AllocateContiguousPagesForMdl

AllocateContiguousPagesForMdl 方法會配置連續、非分頁、物理記憶體頁面的清單,並傳回描述它們的記憶體描述項清單指標 (MDL) 。
IPortWaveRTStream::AllocatePagesForMdl

AllocatePagesForMdl 方法會配置非分頁實體記憶體頁面的清單,並傳回描述它們的記憶體描述項清單指標 (MDL) 。
IPortWaveRTStream::FreePagesFromMdl

FreePagesFromMdl 方法會釋放記憶體描述項清單, (MDL) 。
IPortWaveRTStream::GetPhysicalPageAddress

GetPhysicalPageAddress 方法會傳回記憶體描述元清單內頁面的實體位址, (MDL) 。
IPortWaveRTStream::GetPhysicalPagesCount

GetPhysicalPagesCount 方法會傳回記憶體描述元清單中的實體頁面計數, (MDL) 。
IPortWaveRTStream::MapAllocatedPages

MapAllocatedPages 方法會將先前配置的實體頁面清單對應到可從內核模式存取的連續虛擬記憶體區塊。
IPortWaveRTStream::UnmapAllocatedPages

UnmapAllocatedPages 方法會釋放對應。

規格需求

需求
目標平台 Windows
標頭 portcls.h