次の方法で共有

GPIO_CLX_RegisterClient関数 (gpioclx.h)

  • [アーティクル]

GPIO_CLX_RegisterClient メソッドは、汎用 I/O (GPIO) コントローラー ドライバーを 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以降で使用できます。
対象プラットフォーム ユニバーサル
Header gpioclx.h
Library Msgpioclxstub.lib
IRQL PASSIVE_LEVEL

こちらもご覧ください

DriverEntry

GPIO_CLIENT_REGISTRATION_PACKET

GPIO_CLX_UnregisterClient

UNICODE_STRING