共用方式為

KsValidateConnectRequest 函式 （ks.h）

  • 發行項

KsValidateConnectRequest 函式會驗證連接要求，並傳回與要求相關聯之連接結構的指標。

此函式只能在PASSIVE_LEVEL呼叫。

語法

KSDDKAPI NTSTATUS KsValidateConnectRequest(
  [in]  PIRP                   Irp,
  [in]  ULONG                  DescriptorsCount,
  [in]  const KSPIN_DESCRIPTOR *Descriptor,
  [out] PKSPIN_CONNECT         *Connect
);

參數

[in] Irp

指定連接要求的 IRP 指標。

[in] DescriptorsCount

指定傳遞的針腳描述項數目。

[in] Descriptor

指定 KSPIN_DESCRIPTOR 結構的指標。

[out] Connect

指定要將指標放在傳遞至建立要求之 KSPIN_CONNECT 指標的位置。 如果 KsValidateConnectRequest 傳回成功，則 Connect+1 會包含已開啟針腳的 KSDATAFORMAT 指標。

傳回值

KsValidateConnectRequest 函式會在成功時傳回STATUS_SUCCESS，或傳回錯誤。

言論

KsValidateConnectRequest 函式會處理基本的連線結構存取例外狀況，並驗證通訊需求、媒體、通訊協定和基本數據格式。 針對所傳遞之數據格式執行的驗證是以要建立針腳實例所依據之指定針腳的數據範圍清單為基礎。 驗證在三個實例中成功：如果範圍主要格式是通配符，則範圍主要格式相符，而範圍子格式為通配符，或範圍主要格式、範圍子格式和範圍規範全部相符。

如果原始輸入緩衝區不在核心模式中，則緩衝區會傳遞原始輸入緩衝區的複本，因此是安全的存取。

要求

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