KsCreatePin2 函式 (ks.h)
將連線要求傳遞至裝置，以建立釘選實例。
支援從 Windows 8 開始。
語法
KSDDKAPI HRESULT KsCreatePin2(
[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 函式 的連線。
傳回值
如果成功，則傳回 NOERROR ;否則，傳回錯誤碼。
備註
這是 KsCreatePin 函式的新版本，並使用裝置代理程式建立核心串流物件的句柄。 此外，必須先呼叫元件物件模型 (COM) CoInitialize 函式，才能呼叫此函式。
例程會將 IRP_MJ_CREATE 要求傳送給驅動程式。 只有在介面、中型和數據格式相容時，驅動程式才會接受要求。
如果 Connect-PinToHandle> 為 NULL，KsCreatePin2 會建立 Pin，讓呼叫端可用來將要求傳送至 Connect-FilterHandle> 中指定的串流驅動程式。 Connect-PinId> 決定要建立的針腳類型。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 |
| 最低支援的伺服器 | Windows Server 2012 |
| 目標平台 | Universal |
| 標頭 | ks.h (包含 Ks.h) |
| IRQL | PASSIVE_LEVEL |