KsCreatePin 函式 (ks.h)
KsCreatePin 函式會將連線要求傳遞至裝置,以建立釘選實例。 此函式只能在核心模式用戶端 PASSIVE_LEVEL 呼叫。
語法
KSDDKAPI NTSTATUS KsCreatePin(
[in] HANDLE FilterHandle,
[in] PKSPIN_CONNECT Connect,
[in] ACCESS_MASK DesiredAccess,
[out] PHANDLE ConnectionHandle
);
參數
[in] FilterHandle
指定起始建立要求之篩選的句柄,以及連接發生的位置。
[in] Connect
包含所要求連接參數之 KSPIN_CONNECT 結構的指標。 這應該在記憶體中接著 KSDATAFORMAT 數據結構,描述為連線要求的數據格式。
[in] DesiredAccess
指定針腳所需的存取權。 這通常是 GENERIC_READ 或 GENERIC_WRITE。 對於流入釘選的數據,此值應設定為 GENERIC_WRITE,而對於從針腳流出的數據,則不論通訊方法為何,都應該設定為 GENERIC_READ。
[out] ConnectionHandle
指定傳遞的連接句柄。 例程會將這個 填入至所建立連接之檔案物件的句柄。 然後,這個值可以用來中斷與 closeHandle 函式 的連線。
傳回值
如果連線成功,KsCreatePin 函式會傳回 STATUS_SUCCESS,如果連線失敗,則會傳回錯誤。 此外,可以傳回此 Win32 錯誤碼(來自 Winerror.h):
言論
例程會將 IRP_MJ_CREATE 要求傳送至驅動程式。 只有在介面、中型和數據格式相容時,驅動程式才會接受要求。
如果 Connect->PinToHandleNULL,KsCreatePin 會建立呼叫者可用來將要求傳送至 Connect ->FilterHandle中指定的串流驅動程式。 Connect->PinId 決定要建立的針腳類型。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
標頭 | ks.h (包括 Ks.h) |
連結庫 | Ks.lib |