KsCreatePin 함수(ks.h)
KsCreatePin 함수는 디바이스에 연결 요청을 전달하여 핀 instance 만듭니다. 이 함수는 커널 모드 클라이언트에 대해 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 요청을 보냅니다. 드라이버는 인터페이스, 중간 및 데이터 형식이 호환되는 경우에만 요청을 수락합니다.
Connect-PinToHandle> 이 NULL인 경우 KsCreatePin은 호출자가 Connect-FilterHandle>에 지정된 스트리밍 드라이버에 요청을 보내는 데 사용할 수 있는 핀을 만듭니다. Connect-PinId>는 만들 핀의 핀 유형을 결정합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 헤더 | ks.h(Ks.h 포함) |
| 라이브러리 | Ks.lib |