HWN_CLIENT_GET_STATE 콜백 함수(hwnclx.h)

하드웨어 알림 구성 요소 상태를 가져오기 위해 클라이언트 드라이버에 의해 구현됩니다. 사용자가 상태 정보를 요청할 때 호출됩니다.

구문

HWN_CLIENT_GET_STATE HwnClientGetState;

NTSTATUS HwnClientGetState(
  [in]  PVOID Context,
  [out] PVOID OutputBuffer,
  [in]  ULONG OutputBufferLength,
  [in]  PVOID InputBuffer,
  [in]  ULONG InputBufferLength,
  [out] PULONG BytesRead
)
{...}

매개 변수

[in] Context

클라이언트 드라이버의 컨텍스트 정보에 대한 포인터입니다. 이 메모리 공간은 클라이언트 드라이버에서 사용할 수 있습니다. WdfDeviceCreate에 의해 프레임워크 개체 컨텍스트 공간의 일부로 할당됩니다. 자세한 내용은 HWN_CLIENT_REGISTRATION_PACKET 및 Framework 개체 컨텍스트 공간을 참조하세요.

[out] OutputBuffer

하드웨어 알림 상태 쓰기 위한 OutputBufferLength 바이트의 버퍼입니다. 함수가 성공하면 버퍼에는 하나 이상의 HWN_SETTINGS 구조를 포함하는 HWN_HEADER 구조체 가 포함됩니다.

참고  

OutputBufferLength 는 요청된 모든 설정을 포함할 수 있을 만큼 커야 합니다. 자세한 내용은 설명 부분을 참조하세요.

 

[in] OutputBufferLength

OutputBuffer의 크기(바이트)입니다.

[in] InputBuffer

요청된 하드웨어 알림 구성 요소에 대한 ID가 HwNId 필드에 저장되는 하나 이상의 HWN_SETTINGS구조를 포함하는 HWN_HEADER 포함하는 InputBufferLength 바이트의 버퍼입니다. 이 버퍼는 NULL일 수 있습니다.

[in] InputBufferLength

InputBuffer의 크기(바이트)입니다.

[out] BytesRead

함수에서 읽은 바이트 수를 나타내는 변수에 대한 포인터입니다.

반환 값

작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 적절한 NTSTATUS 오류 코드를 반환합니다.

설명

HWN_CLIENT_REGISTRATION_PACKET 적절한 멤버를 설정한 다음 HwNRegisterClient를 호출하여 이 콜백 함수의 구현을 등록합니다.

• InputBuffer가 NULL인 경우 출력 버퍼는 드라이버에서 구현한 하드웨어 알림에 대한 모든 설정을 포함하는 HWN_HEADER 구조를 저장하는 데 사용됩니다.

  하드웨어 알림 구성 요소에 대한 설정은 HWN_SETTINGS 구조에 저장됩니다. HWN_HEADER 구조체의 HwNSettingsInfo 필드에는 HWN_SETTINGS 구조체의 배열이 포함되어 있습니다.

• InputBuffer가 null이 아니고 형식이 올바르게 지정되면 하나 이상의 HWN_SETTINGS 구조체가 있는 HWN_HEADER 포함됩니다. 요청된 하드웨어 알림 구성 요소의 ID는 HWN_SETTINGS 구조의 HwNId 필드에 저장됩니다. 나머지 설정은 유효한 설정이거나 0이어야 합니다.
• OutputBuffer가 요청된 모든 설정을 포함할 만큼 크지 않은 경우 이 함수는 OutputBuffer에 아무 것도 쓰지 않아야 합니다. 또한 BytesRead 를 0으로 설정하고 오류를 반환해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 10, 버전 1709
지원되는 최소 서버	Windows Server 2016
대상 플랫폼	Windows
헤더	hwnclx.h
IRQL	PASSIVE_LEVEL

추가 정보

하드웨어 알림 지원

하드웨어 알림 참조