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 は、呼び出し元が Connect-FilterHandle> で指定されたストリーミング ドライバーに要求を送信するために使用できるピンを作成します。 Connect-PinId> は、作成するピンの種類を決定します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 |
| サポートされている最小のサーバー | Windows Server 2012 |
| 対象プラットフォーム | ユニバーサル |
| Header | ks.h (Ks.h を含む) |
| IRQL | PASSIVE_LEVEL |