IOCTL_BTHHFP_SPEAKER_GET_VOLUME_STATUS_UPDATE IOCTL(bthhfpddi.h)

아티클
08/07/2023

IOCTL_BTHHFP_SPEAKER_GET_VOLUME_STATUS_UPDATE IOCTL은 Bluetooth 디바이스 스피커의 볼륨 수준 설정을 가져옵니다.

주 코드

IRP_MJ_DEVICE_CONTROL

입력 버퍼

즉각적인 업데이트를 요청하기 위해 TRUE로 설정된 BOOL입니다. 그렇지 않으면 FALSE로 설정합니다.

입력 버퍼 길이

BOOL의 크기입니다.

출력 버퍼

1/65536 데시벨로 화자의 볼륨 수준을 나타내는 LONG입니다.

출력 버퍼 길이

LONG의 크기입니다.

상태 블록

요청이 이미 보류 중인 경우 새 요청이 실패하고 STATUS_INVALID_DEVICE_REQUEST 메시지가 반환됩니다.

설명

입력 매개 변수가 TRUE이거나 마지막 요청 이후 볼륨 상태 변경된 경우 이 요청은 즉시 완료됩니다. 그렇지 않으면 볼륨 상태 변경되거나 요청이 취소될 때까지 이 요청은 보류 상태로 유지됩니다.

오디오 드라이버는 초기 스피커 및 마이크 볼륨 수준을 가져오기 위해 이 요청을 보내고, 레벨이 변경될 때 업데이트할 후속 요청 "요청"을 보냅니다. 드라이버는 볼륨 수준을 적절한 컨텍스트 데이터에 저장합니다. 볼륨 수준이 변경되면 오디오 드라이버는 스피커 또는 마이크 경로의 KS 토폴로지에서 KSNODETYPE_VOLUME 노드에 대한 KSEVENT_CONTROL_CHANGE 이벤트를 생성합니다.

요청의 출력 매개 변수는 KSPROPERTY_AUDIO_VOLUMELEVEL 속성 값과 동일합니다.