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->PinToHandleNULL，KsCreatePin2 會建立呼叫者可用來將要求傳送至 Connect中指定的串流驅動程式的 pin->FilterHandle。 Connect->PinId 決定要建立的釘選類型。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 8 |
| 支援的最低伺服器 | Windows Server 2012 |
| 目標平臺 | 普遍 |
| 標頭 | ks.h （包括 Ks.h） |
| IRQL | PASSIVE_LEVEL |