共用方式為

KsAcquireCachedMdl 函式 （ks.h）

  • 發行項

此函式可用來取得 KS 連接埠驅動程式快取的 MDL。 核心模式驅動程式會使用 函式來取得 Avstream 驅動程式所產生的管線提供範例的 MDL。

語法

KSDDKAPI NTSTATUS KsAcquireCachedMdl(
  PIRP                 Irp,
  REFGUID              Guid,
  PFNKSCANCELPINNEDMDL CancelRoutine,
  PVOID                CancelContext,
  PMDL                 *MdlAddr,
  PVOID                *ReleaseContext
);

參數

Irp

從包含使用者模式範例緩衝區的使用者模式傳遞的 IRP。

Guid

從管線傳遞之 IMFSamp leMFSampleExtension_MDLCacheCookie 屬性專案中擷取的 GUID。

CancelRoutine

取消例程，Avstream 迷你埠驅動程式所提供的回呼函式。 當產生範例的針腳狀態要停止狀態時，就會呼叫此函式。 取消例程的簽章如下所示：

_IRQL_requires_max_(DISPATCH_LEVEL)
typedef
VOID
(*PFNKSCANCELPINNEDMDL)(
    _In_ GUID,
    _In_ PVOID,
    _In_ PVOID
);

GUID
由Avstream迷你埠驅動程式傳入 KsAcquireCachedMdl 函式中的 GUID。

PVOID
在 KsAcquireCachedMdl 函數調用中，取消 Avstream 迷你埠驅動程式提供的內容。

PVOID
發行內容。 這是 KsAcquireCachedMdl 函式的輸出。

CancelContext

在取消例程中傳遞至Avstream驅動程序的內容。 Avstream 驅動程式會使用此內容進入驅動程序內容。

MdlAddr

傳回值：如果 KS 找到為範例緩衝區儲存的 MDL，則為結果 MDL。

ReleaseContext

傳回值：Avstream 驅動程式要儲存的內容。 發行 KsAcquireCachedMdl 呼叫取得的 MDL 時，應該將此內容傳遞至 KS。

傳回值

傳回成功條件STATUS_SUCCESS。

要求

要求 價值
目標平臺 普遍
標頭 ks.h （包括 Ks.h）
連結庫 Ks.lib