GPIO_CLX_RegisterClient 함수(gpioclx.h)

  • 아티클

GPIO_CLX_RegisterClient 메서드는 GPIO(범용 I/O) 컨트롤러 드라이버를 GPIO 프레임워크 확장(GpioClx)의 클라이언트로 등록합니다.

구문

NTSTATUS GPIO_CLX_RegisterClient(
  [in]      WDFDRIVER                        Driver,
  [in, out] PGPIO_CLIENT_REGISTRATION_PACKET RegistrationPacket,
  [in]      PUNICODE_STRING                  RegistryPath
);

매개 변수

[in] Driver

GPIO 컨트롤러 드라이버에 대한 프레임워크 드라이버 개체에 대한 WDFDRIVER 핸들입니다.

[in, out] RegistrationPacket

호출자의 등록 정보를 포함하는 호출자가 할당한 GPIO_CLIENT_REGISTRATION_PACKET 구조체에 대한 포인터입니다. 이 구조에는 GPIO 컨트롤러 드라이버가 구현하는 이벤트 콜백 함수에 대한 포인터가 포함되어 있습니다. 또한 이 구조는 GPIO 컨트롤러 드라이버가 내부 구성 데이터 및 상태 정보에 필요한 디바이스 컨텍스트의 크기를 지정합니다.

[in] RegistryPath

GPIO 컨트롤러 드라이버에 대한 레지스트리 키의 경로 이름을 포함하는 UNICODE_STRING 구조체에 대한 포인터입니다. 이 매개 변수는 드라이버의 DriverEntry 루틴에 전달된 레지스트리 경로 이름이어야 합니다. 드라이버 레지스트리 키에 대한 자세한 내용은 디바이스 및 드라이버용 레지스트리 트리를 참조하세요.

반환 값

GPIO_CLX_RegisterClient 호출에 성공하면 STATUS_SUCCESS 반환합니다. 가능한 반환 값에는 다음 오류 코드가 포함됩니다.

반환 코드 설명
STATUS_INVALID_PARAMETER
 Driver, RegistrationPacket 또는 RegistryPath 매개 변수는 NULL입니다.
STATUS_GPIO_INVALID_REGISTRATION_PACKET
 지정된 등록 패킷이 잘못되었습니다.
STATUS_INSUFFICIENT_RESOURCES
 메모리가 부족합니다.

설명

GPIO 컨트롤러 드라이버는 이 메서드를 호출하여 GpioClx에 이벤트 콜백 함수를 등록합니다. 일반적으로 드라이버는 드라이버가 메모리에 로드된 직후 실행되는 DriverEntry 루틴에서 이 메서드를 호출합니다.

나중에 GPIO 컨트롤러 드라이버가 언로드되기 직전에 드라이버는 GPIO_CLX_UnregisterClient 메서드를 호출하여 GpioClx에 대한 등록을 취소합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8 사용하여 사용할 수 있습니다.
대상 플랫폼 유니버설
헤더 gpioclx.h
라이브러리 Msgpioclxstub.lib
IRQL PASSIVE_LEVEL

추가 정보

DriverEntry

GPIO_CLIENT_REGISTRATION_PACKET

GPIO_CLX_UnregisterClient

UNICODE_STRING