피드백

KdPrintEx 매크로(wdm.h)

  • 아티클
  • 읽는 데 4분 걸림

지정한 조건이 충족되면 KdPrintEx 매크로는 커널 디버거에 문자열을 보냅니다.

KdPrintEx를 호출하려면 이중 괄호가 필요합니다.

구문

void KdPrintEx(
   _x_
);

매개 변수

_x_

printf와 같이 형식 문자열에 대한 인수를 지정합니다.

반환 값

없음

설명

KdPrintEx 는 디버그 구성을 위해 컴파일되는 코드의 DbgPrintEx 루틴과 동일합니다. 이 루틴은 릴리스 빌드에 대해 컴파일된 코드에 영향을 주지 않습니다. 커널 모드 드라이버만 KdPrintEx 루틴을 호출할 수 있습니다.

참고 WDK(Windows Driver Kit) 8 및 WDK 7은 디버그(확인) 및 릴리스(무료) 빌드에 적합한 DBG 전처리기 상수 정의를 관리합니다. 자세한 내용은 조건부 컴파일 및 빌드 환경을 참조하세요.

KdPrintEx 는 지정된 문자열을 커널 디버거에 전달하거나 ComponentId, Level 및 해당 구성 요소 필터 마스크의 값에 따라 아무 작업도 수행하지 않습니다. 자세한 내용은 디버깅 메시지 읽기 및 필터링을 참조하세요.

반드시 필요한 경우가 아니면 사용자 입력 또는 다른 프로세스에서 문자열을 가져와 KdPrintEx에 전달하면 안 됩니다. 만들지 않은 문자열을 사용하는 경우 올바른 형식 문자열이고 형식 코드가 형식 및 수량의 인수 목록과 일치하는지 확인해야 합니다. 가장 좋은 코딩 방법은 모든 형식 문자열이 정적이고 컴파일 시간에 정의되는 것입니다.

형식 문자열의 크기 또는 인수 수에 대한 상한은 없습니다. 그러나 KdPrintEx 에 대한 단일 호출은 512바이트의 정보만 전송합니다. DbgPrint 버퍼의 크기도 제한됩니다. 자세한 내용은 DbgPrint 버퍼 및 디버거 를 참조하세요.

이 루틴은 ntddk.h 및 ndis.h로 정의됩니다. 구성 요소 필터 ID는 dpfilter.h, ndis.h 및 wdm.h에 정의됩니다. ntddk.h 또는 ndis.h를 포함합니다.

다음은 인수입니다.

  • ComponentId [in]

이 루틴을 호출하는 구성 요소를 지정합니다. dpfilter.h 헤더 파일에 정의된 구성 요소 이름 필터 ID 중 하나여야 합니다. 드라이버의 출력을 Windows 구성 요소의 출력과 혼합하지 않도록 하려면 ComponentId에 다음 값만 사용해야 합니다.

  • DPFLTR_IHVVIDEO_ID
  • DPFLTR_IHVAUDIO_ID
  • DPFLTR_IHVNETWORK_ID
  • DPFLTR_IHVSTREAMING_ID
  • DPFLTR_IHVBUS_ID
  • DPFLTR_IHVDRIVER_ID
  • 서식 [in]

인쇄할 서식 문자열에 대한 포인터를 지정합니다. 서식 문자열은 대부분의 printf 스타일 서식 사양 필드를 지원합니다. 그러나 유니코드 형식 코드(%C, %S, %lc, %ls, %wc, %ws 및 %wZ)는 IRQL = PASSIVE_LEVEL 함께만 사용할 수 있습니다. KdPrintEx 루틴은 부동 소수점 형식(%f, %e, %E, %g, %G, %a 또는 %A)을 지원하지 않습니다.

  • 수준 [in]

이 메시지의 심각도를 지정합니다. 32비트 정수일 수 있습니다. 0에서 31 사이의 값(포함)은 32에서 0xFFFFFFFF 사이의 값과 다르게 처리됩니다. 자세한 내용은 디버깅 메시지 읽기 및 필터링을 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 Microsoft Windows XP 이상에서 사용할 수 있습니다.
대상 플랫폼 데스크톱
헤더 wdm.h(Wdm.h 포함)
라이브러리 NtosKrnl.lib(DbgPrintEx 참조)
DLL NtosKrnl.exe

참고 항목

DbgPrint

DbgPrintEx

KdPrint