IOCTL_PWM_CONTROLLER_GET_INFO IOCTL (pwm.h)

[アーティクル]
03/01/2024

パルス幅変調 (PWM) コントローラーに関する情報を取得します。この情報は、コントローラーが初期化された後は変更されません。

[入力バッファー]

この操作では使用されません。NULL に設定します。

入力バッファーの長さ

この操作では使用されません。を 0 に設定します。

出力バッファー

PWM_CONTROLLER_INFO構造体を含むバッファーへのポインター。これは、パルス幅変調(PWM)コントローラを特徴付ける静的情報を表します。

出力バッファーの長さ

出力バッファーのサイズは、要求された PWM_CONTROLLER_INFO 構造体のサイズと正確に等しい必要があります。新しいPWM_CONTROLLER_INFOバージョンはすべて、以前のバージョンよりも大きいバイトサイズを持っています。

注釈

この操作を実行するには、次のパラメーターを使用して DeviceIoControl 関数を呼び出します。

BOOL 
   WINAPI 
   DeviceIoControl( (HANDLE)       hDevice,         // handle to device
                    (DWORD)        IOCTL_PWM_CONTROLLER_GET_INFO, // dwIoControlCode(LPDWORD)      NULL,      // input buffer
                    (DWORD)        0,   // size of input buffer
                    (LPDWORD)      lpOutBuffer,     // output buffer
                    (DWORD)        nOutBufferSize,  // size of output buffer
                    (LPDWORD)      lpBytesReturned, // number of bytes returned
                    (LPOVERLAPPED) lpOverlapped );  // OVERLAPPED structure

パラメーター	説明
hDevice [in]	デバイスへのハンドル。デバイスハンドルを取得するには、 CreateFile 関数を呼び出します。
dwIoControlCode [in]	操作の制御コード。この操作にはIOCTL_PWM_CONTROLLER_GET_ACTUAL_PERIOD を使用します。
lpInBuffer	この操作では使用されません。NULL に設定します。
nInBufferSize [in]	この操作では使用されません。を 0 に設定します。
lpOutBuffer [out]	PWM_CONTROLLER_INFO構造体を含むバッファーへのポインター。これは、パルス幅変調(PWM)コントローラを特徴付ける静的情報を表します。
nOutBufferSize [in]	出力バッファーのサイズは、要求された PWM_CONTROLLER_INFO 構造体のサイズと正確に等しい必要があります。新しいPWM_CONTROLLER_INFOバージョンはすべて、以前のバージョンよりも大きいバイトサイズを持っています。
lpBytesReturned [out]	出力バッファーに格納されているデータのサイズをバイト単位で受け取る変数へのポインター。出力バッファーが小さすぎる場合、呼び出しは失敗し、GetLastError はERROR_INSUFFICIENT_BUFFERを返し、lpBytesReturned は 0 です。 lpOverlapped が NULL の場合、lpBytesReturned を NULL にすることはできません。操作で出力データが返されず、lpOutBuffer が NULL の場合でも、DeviceIoControl は lpBytesReturned を使用します。このような操作の後、lpBytesReturned の値は意味がありません。 lpOverlapped が NULL でない場合、lpBytesReturned には NULL を指定できます。このパラメーターが NULL ではなく、操作がデータを返す場合、重複する操作が完了するまで lpBytesReturned は意味がありません。返されたバイト数を取得するには、GetOverlappedResult を呼び出します。 hDevice パラメーターが I/O 入力候補ポートに関連付けられている場合は、GetQueuedCompletionStatus を呼び出して返されるバイト数を取得できます。
lpOverlapped [in]	OVERLAPPED 構造体へのポインター。 FILE_FLAG_OVERLAPPED を指定せずに hDevice を開いた場合、lpOverlapped は無視されます。 hDevice が FILE_FLAG_OVERLAPPED フラグで開かれた場合、操作は重複 (非同期) 操作として実行されます。この場合、lpOverlapped は、イベントオブジェクトへのハンドルを含む有効な OVERLAPPED 構造体を指す必要があります。それ以外の場合、関数は予期しない方法で失敗します。重複する操作の場合、DeviceIoControl は直ちに戻り、操作が完了するとイベントオブジェクトが通知されます。それ以外の場合、関数は操作が完了するかエラーが発生するまで戻りません。

バッファーサイズが最小の構造体バージョンのサイズより小さい場合は、IOCTL 完了状態の STATUS_BUFFER_TOO_SMALLを使用して要求が完了します。それ以外の場合、ドライバーは、指定された出力バッファーに収まる可能性がある最高の構造体バージョンを想定し、要求を正常に完了します。

要件

要件	値
サポートされている最小のクライアント	Windows 10 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2016 [デスクトップアプリのみ]
Header	pwm.h (Pwm.h を含む)

こちらもご覧ください

DeviceIoControl

次の方法で共有