KsCreatePin2 함수(ks.h)

디바이스에 연결 요청을 전달하여 핀 instance 만듭니다.

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>는 만들 핀 유형을 결정합니다.

요구 사항

추가 정보

CoInitialize

IRP_MJ_CREATE

KSDATAFORMAT

KSPIN_CONNECT

KsCreatePin