Framework 개체 사용자 지정 형식

아티클
08/08/2022
읽는 데 2분 걸림

KMDF 버전 1.11부터 프레임워크는 사용자 지정 형식 이름을 지원합니다. 사용자 지정 형식 이름은 드라이버가 WDFOBJECT 인스턴스와 연결할 수 있는 문자열입니다. 드라이버는 고유한 사용자 지정 형식 이름을 정의합니다. 드라이버는 드라이버가 개체의 생성 메서드를 호출한 후 개체에 대한 사용자 지정 형식 이름을 지정합니다.

다음 매크로를 사용하여 사용자 지정 형식 이름을 조작합니다.

사용자 지정 형식 이름을 정의하려면 헤더 파일과 같은 전역 데이터를 선언하는 드라이버 영역에서 WDF_DECLARE_CUSTOM_TYPE 호출합니다.
WdfObjectAddCustomType 또는 WdfObjectAddCustomTypeWithData를 호출하여 사용자 지정 형식을 프레임워크 개체와 연결합니다.
WdfObjectIsCustomType을 호출하여 지정된 개체가 지정된 사용자 지정 형식인지 여부를 확인합니다.
WdfObjectAddCustomTypeWithData를 호출한 후 드라이버는 나중에 WdfObjectGetCustomTypeData를 호출하여 데이터를 검색할 수 있습니다.

드라이버는 여러 사용자 지정 형식을 단일 프레임워크 개체와 연결할 수 있습니다. 드라이버는 여러 프레임워크 개체를 단일 사용자 지정 형식과 연결할 수도 있습니다.

KMDF 디버거 확장의 출력에서 사용자 지정 형식 이름은 다른 WDF 개체 정보와 함께 표시됩니다.

WDF_Object_Name, [custom_Type1_Name, custom_Type2_Name]