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 ，如果連線失敗，則會傳回錯誤。 此外，您可以從 Winerror.h 傳回此 Win32 錯誤碼 () ：
備註
例程會將 IRP_MJ_CREATE 要求傳送給驅動程式。 只有在介面、中型和數據格式相容時，驅動程式才會接受要求。
如果 Connect-PinToHandle> 為 NULL，KsCreatePin 會建立 PIN，呼叫端可用來將要求傳送至 Connect-FilterHandle> 中指定的串流驅動程式。 Connect-PinId> 決定要建立的針腳類型。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 標頭 | ks.h (包含 Ks.h) |
| 程式庫 | Ks.lib |