PFNKSPINIRP 回檔函式 (ks.h)
執行針腳上的活動並接收下列 IRP 時,會呼叫 AVStream 迷你驅動程式的例程:
語法
PFNKSPINIRP Pfnkspinirp;
NTSTATUS Pfnkspinirp(
[in] PKSPIN Pin,
[in] PIRP Irp
)
{...}
參數
[in] Pin
剛建立之 KSPIN 的指標。
[in] Irp
Pin之 IRP 的指標。
傳回值
如果例程成功,則作業保證會成功。 傳回STATUS_SUCCESS或STATUS_PENDING。
言論
IRP | 描述 |
---|---|
IRP_MJ_CREATE | 一般而言,此例程是由想要初始化與釘選相關聯的內容和資源之迷你驅動程式使用。 minidriver 會在其 KSPIN_DISPATCH 結構 建立 成員中指定此例程的位址。 建立針腳時會呼叫此例程。 呼叫此例程時,檔案物件具有相關聯的內容,且已配置 KS 對象標頭。 一般而言,此函式會由想要初始化與釘選相關聯之內容和資源的迷你驅動程式提供。 此函式中會保留篩選控件 Mutex。 函式將在 IRQL = PASSIVE_LEVEL呼叫。 此例程是選擇性的。 如果例程成功,則建立作業保證會成功。 傳回STATUS_SUCCESS或STATUS_PENDING。 如果迷你驅動程式傳回STATUS_PENDING,AVStream 將不會立即完成 IRP_MJ_CREATE。 不過,在傳回STATUS_PENDING之前,minidriver 必須呼叫 IoMarkIrpPending。 建立完成處理之後,minidriver 必須設定 IRP 的狀態代碼,然後呼叫 KsCompletePendingRequest。 |
IRP_MJ_CLOSE | minidriver 會在其 KSPIN_DISPATCH 結構的 Close 成員中指定此例程的位址。 在呼叫例程時,已釋放針腳上任何已註冊的事件,但物件會保持不變。 此函式中會保留篩選控件 Mutex。 如需 mutex 的詳細資訊,請參閱 AVStream 中的 Mutexes。 此例程是選擇性的。 |
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | ks.h (包括 Ks.h) |
IRQL | PASSIVE_LEVEL (請參閱一節) |