IOCTL_BTHX_WRITE_HCI IOCTL(bthxddi.h)

IOCTL_BTHX_WRITE_HCI 전송 계층에 Bluetooth ACL 데이터 및 명령을 쓰는 데 사용됩니다.

프로필 드라이버는 KMDF 및 WdfRequestRetrieveInputMemory 메서드를 사용하여 입력 매개 변수를 검색해야 합니다. 예를 들어 입력 버퍼를 얻으려면 다음을 수행합니다.

Status = WdfRequestRetrieveInputMemory(_Request, &ReqInMemory);

버퍼는 쓰기 유형 및 쓰기와 연결된 데이터를 지정하는 BTHX_HCI_READ_WRITE_CONTEXT 구조체를 설명합니다.

자세한 내용은 WDK Bluetooth 샘플을 참조하세요.

버퍼의 길이는 BTHX_HCI_READ_WRITE_CONTEXT 구조체의 크기입니다.

프로필 드라이버는 KMDF 및 해당 WdfRequestRetrieveOutputMemory 메서드를 사용하여 입력 매개 변수를 검색해야 합니다. 예를 들어 출력 버퍼를 얻으려면 다음을 수행합니다.

Status = WdfRequestRetrieveOutputMemory(_Request, &ReqOutMemory);

버퍼는 BTHX_HCI_READ_WRITE_CONTEXT 구조에 지정된 입력 데이터에 대해 작성된 바이트 수의 ULONG을 설명합니다.

자세한 내용은 WDK Bluetooth 샘플을 참조하세요.

버퍼의 길이는 ULONG의 크기입니다.

요청이 성공하면 STATUS_BLOCK 구조의 정보 멤버가 출력 매개 변수의 바이트 수로 설정됩니다.

Status 멤버는 다음 표의 값 중 하나로 설정됩니다.

상태 값	Description
STATUS_SUCCESS	IOCTL이 성공적으로 완료되었습니다.

설명

Bluetooth 스택은 IOCTL_BTHX_WRITE_HCI 보내 HCI ACL 데이터 및 HCI 명령을 컨트롤러에 씁니다.

입력 버퍼는 DataLen 멤버가 데이터 멤버의 바이트 수를 지정하는 BTHX_HCI_READ_WRITE_CONTEXT 구조를 가리킵니다. Type 멤버는 패킷이 명령 패킷인지 ACL 데이터 패킷인지에 따라 설정됩니다.