USBCAMD_ControlVendorCommand関数 (usbcamdi.h)

  • [アーティクル]

USBCAMD_ControlVendorCommand関数は、ベンダー固有のコマンドをコントロール パイプに送信します。

構文

NTSTATUS USBCAMD_ControlVendorCommand(
  [in]                PVOID                      DeviceContext,
  [in]                UCHAR                      Request,
  [in]                USHORT                     Value,
  [in]                USHORT                     Index,
  [in, out, optional] PVOID                      Buffer,
  [in, out]           PULONG                     BufferLength,
  [in]                BOOLEAN                    GetData,
  [in, optional]      PCOMMAND_COMPLETE_FUNCTION CommandComplete,
  [in, optional]      PVOID                      CommandContext
);

パラメーター

[in] DeviceContext

デバイス固有のコンテキストへのポインター。

[in] Request

vendor コマンドの [要求 ] フィールドの値を指定します。

[in] Value

vendor コマンドの [値 ] フィールドの値を指定します。

[in] Index

vendor コマンドの [インデックス ] フィールドの値を指定します。

[in, out, optional] Buffer

コマンドにデータがある場合は、データ バッファーへのポインター。 コマンドにデータがない場合、この値は NULL です。

[in, out] BufferLength

バッファー長の値へのポインター。 バッファーの長さはバイト単位で表されます。 Buffer の値が NULL の場合、BufferLength も NULL になる可能性があります。

[in] GetData

GetData は、デバイスからホストにデータが送信されたことを示します。

[in, optional] CommandComplete

カメラ ミニドライバー定義 の CommandCompleteFunction へのポインター。これは、一括読み取りまたは書き込みが完了したときに呼び出されます。 この値には NULL を指定できます。

[in, optional] CommandContext

カメラ ミニドライバー定義の CommandCompleteFunction に引数として渡されるメモリ ブロックへのポインター。

戻り値

USBCAMD_ControlVendorCommand ベンダー コマンドから NTSTATUS コードを返します。

その他のエラー コードは次のとおりです。

リターン コード 説明
STATUS_PENDING vendor コマンドは延期されます。
STATUS_INSUFFICIENT_RESOURCES ベンダー コマンドを割り当てるためのリソースが不足しています。

注釈

この関数は、IRQL >= PASSIVE_LEVELで呼び出される場合があります。 関数が IRQL > PASSIVE_LEVELで呼び出された場合、コマンドは遅延されます。 完了後、カメラ ミニドライバー定義 の CommandCompleteFunction が呼び出され、 CommandContext 引数 *.* の値が渡されます。

要件

要件 値
対象プラットフォーム デスクトップ
Header usbcamdi.h (Usbcamdi.h を含む)
Library Usbcamd2.lib
IRQL PASSIVE_LEVEL以上 (「解説」セクションを参照)

こちらもご覧ください

CommandCompleteFunction