共用方式為


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_READGENERIC_WRITE。 對於流入釘選的數據,此值應設定為 GENERIC_WRITE,而對於從針腳流出的數據,則不論通訊方法為何,都應該設定為 GENERIC_READ

[out] ConnectionHandle

指定傳遞的連接句柄。 例程會將這個 填入至所建立連接之檔案物件的句柄。 然後,這個值可以用來中斷與 closeHandle 函式 的連線。

傳回值

如果連線成功,KsCreatePin 函式會傳回 STATUS_SUCCESS,如果連線失敗,則會傳回錯誤。 此外,可以傳回此 Win32 錯誤碼(來自 Winerror.h):

言論

例程會將 IRP_MJ_CREATE 要求傳送至驅動程式。 只有在介面、中型和數據格式相容時,驅動程式才會接受要求。

如果 Connect->PinToHandleNULLKsCreatePin 會建立呼叫者可用來將要求傳送至 Connect ->FilterHandle中指定的串流驅動程式。 Connect->PinId 決定要建立的針腳類型。

要求

要求 價值
目標平臺 普遍
標頭 ks.h (包括 Ks.h)
連結庫 Ks.lib

另請參閱

IRP_MJ_CREATE

KSDATAFORMAT

KSPIN_CONNECT