HDAUDIO_BUS_INTERFACE_BDL DDI 개체 가져오기

앞에서 설명한 것처럼 오디오 또는 모뎀 코덱의 함수 드라이버는 HD 오디오 버스 드라이버에 IRP_MN_QUERY_INTERFACE IOCTL을 전송하여 HD Audio DDI를 사용하여 개체에 대한 계산된 참조를 가져옵니다.

다음 표에서는 함수 드라이버가 IOCTL에 기록하여 이 구조가 정의하는 HD Audio DDI 버전에 대한 컨텍스트 개체와 HDAUDIO_BUS_INTERFACE_BDL 구조를 가져오는 입력 매개 변수 값을 보여 줍니다.

매개 변수	값
CONST GUID *InterfaceType	GUID_HDAUDIO_BUS_INTERFACE_BDL
USHORT 크기	sizeof(HDAUDIO_BUS_INTERFACE_BDL)
USHORT 버전	0x0100
PINTERFACE 인터페이스	HDAUDIO_BUS_INTERFACE_BDL 구조체에 대한 포인터
PVOID 인터페이스SpecificData	NULL

함수 드라이버는 HDAUDIO_BUS_INTERFACE_BDL 구조체에 대한 스토리지를 할당하고 IOCTL에서 이 구조체에 대한 포인터를 포함합니다. 앞의 표에서 HDAUDIO_BUS_INTERFACE_BDL 구조체에 대한 포인터는 INTERFACE 형식의 구조체에 대한 포인터인 PINTERFACE 형식으로 캐스팅됩니다. HDAUDIO_BUS_INTERFACE_BDL 처음 5개 멤버의 이름과 형식은 INTERFACE의 5개 멤버와 일치합니다. HDAUDIO_BUS_INTERFACE_BDL DDI 루틴에 대한 함수 포인터인 추가 멤버를 포함합니다. 함수 드라이버에서 IOCTL을 수신하면 HD 오디오 버스 드라이버가 전체 HDAUDIO_BUS_INTERFACE_BDL 구조를 채웁니다.

다음 표에서는 HD Audio Bus 드라이버가 HDAUDIO_BUS_INTERFACE_BDL 구조의 처음 5개 멤버에 쓰는 값을 보여 줍니다.

멤버	값
USHORT 크기	sizeof(HDAUDIO_BUS_INTERFACE_BDL)
USHORT 버전	0x0100
PVOID 컨텍스트	모든 DDI 루틴에 첫 번째 호출 매개 변수로 전달되어야 하는 컨텍스트 정보
PINTERFACE_REFERENCE InterfaceReference	컨텍스트 개체의 참조 수를 증가시키는 루틴에 대한 포인터
PINTERFACE_DEREFERENCE InterfaceDereference	컨텍스트 개체의 참조 수를 감소시키는 루틴에 대한 포인터

앞의 표에서 Context 멤버는 클라이언트가 IOCTL에서 가져오는 DDI의 HDAUDIO_BUS_INTERFACE_BDL 버전의 특정 instance 관련된 정보를 포함하는 컨텍스트 개체를 가리킵니다. 앞에서 설명한 대로 DDI에서 루틴을 호출할 때 클라이언트 함수 드라이버는 항상 컨텍스트 포인터 값을 첫 번째 호출 매개 변수로 지정해야 합니다.