IOCTL_KS_PROPERTY IOCTL(ks.h)

아티클
03/01/2024

애플리케이션은 IOCTL_KS_PROPERTY 사용하여 속성을 얻거나 설정하거나 KS 개체에서 지원하는 속성을 확인할 수 있습니다. 애플리케이션은 아래에 설명된 매개 변수를 사용하여 IOCTL_KS_PROPERTY KsSynchronousDeviceControl 함수에 전달합니다.

주 코드

IRP_MJ_DEVICE_CONTROL

입력 버퍼

클라이언트에서 지정한 InBuffer 매개 변수의 내용은 속성 요청에 따라 달라지고 각 속성 집합에 대해 문서화됩니다. instance 경우 KSPROPSETID_Pin 속성 집합의 속성을 요청하는 클라이언트는 KSP_PIN 구조체에 대한 포인터를 지정합니다.

입력 버퍼 길이

애플리케이션은 입력 버퍼 내용의 크기를 InLength 매개 변수에 바이트 단위로 배치합니다.

출력 버퍼

마찬가지로 필요한 출력 버퍼의 형식도 속성 요청에 따라 달라집니다.

출력 버퍼 길이

애플리케이션은 출력 버퍼의 크기를 OutLength 매개 변수에 바이트 단위로 배치합니다.

상태 블록

요청이 성공하면 Status 멤버가 STATUS_SUCCESS 설정됩니다.

설명

입력 및 출력 버퍼 및 해당 크기에 대한 자세한 내용은 KS 속성을 참조하세요.

필터 및 핀은 IOCTL_KS_PROPERTY 디바이스 I/O 컨트롤을 사용하여 속성 집합을 지원합니다. 이 IOCTL은 METHOD_NEITHER 플래그로 정의되지만 속성 데이터는 IOCTL에 출력 버퍼로 전달되고 읽기 액세스를 위해 검색됩니다. KsPropertyHandler 함수는 IOCTL_KS_PROPERTY 통해 요청된 속성을 처리합니다.

유효한 플래그 및 해당 설명 목록은 KSPROPERTY 구조체에 대한 참조 페이지를 참조하세요.