次の方法で共有

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 関数は、基本的な接続構造のアクセス例外を処理し、通信要件、中、プロトコル、および基本データ形式を検証します。 渡されたデータ形式に対して実行される検証は、ピン インスタンスを作成する対象の指定されたピンのデータ範囲リストに基づいています。 範囲メジャー形式がワイルドカードの場合、範囲のメジャー形式が一致し、範囲サブフォーマットがワイルドカードであるか、範囲のメジャー形式、範囲サブフォーマット、および範囲指定子がすべて一致する場合、3 つのインスタンスで検証が成功します。

元の入力バッファーのコピーがバッファーに渡されるのは、発信元がカーネル モードでないため、安全にアクセスできる場合です。

必要条件

要件 価値
ターゲット プラットフォーム の 万国
ヘッダー ks.h (Ks.h を含む)
ライブラリ Ks.lib
  • Last updated on