피드백

KsCreatePin 함수(ks.h)

  • 아티클
  • 읽는 데 2분 걸림

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_READ 또는 GENERIC_WRITE. 핀으로 흐르는 데이터의 경우 이 값은 GENERIC_WRITE 설정해야 하며, 핀 밖으로 흐르는 데이터의 경우 통신 방법에 관계없이 GENERIC_READ 설정해야 합니다.

[out] ConnectionHandle

전달된 연결 핸들을 지정합니다. 루틴은 생성된 연결의 파일 개체에 대한 핸들로 이 값을 채웁니다. 그런 다음 이 값을 사용하여 CloseHandle 함수와의 연결을 끊을 수 있습니다.

반환 값

KsCreatePin 함수는 연결이 성공하면 STATUS_SUCCESS 반환하거나 연결이 실패하면 오류를 반환합니다. 또한 이 Win32 오류 코드(Winerror.h에서)를 반환할 수 있습니다.

설명

루틴은 드라이버에 IRP_MJ_CREATE 요청을 보냅니다. 드라이버는 인터페이스, 중간 및 데이터 형식이 호환되는 경우에만 요청을 수락합니다.

커넥트->PinToHandle이 NULL이면 KsCreatePin은 호출자가 커넥트->FilterHandle에 지정된 스트리밍 드라이버에 요청을 보내는 데 사용할 수 있는 핀을 만듭니다. -> 커넥트PinId는 만들 핀의 핀 유형을 결정합니다.

요구 사항

   
대상 플랫폼 유니버설
헤더 ks.h(Ks.h 포함)
라이브러리 Ks.lib

참조

IRP_MJ_CREATE

KSDATAFORMAT

KSPIN_CONNECT