DXGKDDI_I2C_RECEIVE_DATA_FROM_DISPLAY コールバック関数 (dispmprt.h)

DxgkDdiI2CReceiveDataFromDisplay は、モニター内の I2C デバイスから受信したデータを返します。

構文

DXGKDDI_I2C_RECEIVE_DATA_FROM_DISPLAY DxgkddiI2cReceiveDataFromDisplay;

NTSTATUS DxgkddiI2cReceiveDataFromDisplay(
  [in]  PVOID MiniportDeviceContext,
  [in]  D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
  [in]  ULONG SevenBitI2CAddress,
  [in]  ULONG Flags,
  [in]  ULONG DataLength,
  [out] PVOID Data
)
{...}

パラメーター

[in] MiniportDeviceContext

ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーの DxgkDdiAddDevice 関数は、以前は Microsoft DirectX グラフィックス カーネル サブシステムにこのハンドルを提供しました。

[in] VidPnTargetId

ディスプレイ アダプター上のビデオの存在ターゲットの 1 つを識別する整数。

[in] SevenBitI2CAddress

データの受信元となる I2C デバイスのアドレス。

[in] Flags

I2C デバイスによって送信されるデータの一部としてデータの長さを指定するかどうかを示す 値。 このパラメーターは、次のいずれかの値に設定する必要があります。

[in] DataLength

Data が指すバッファーの長さ (バイト単位)。

[out] Data

データを受信するバッファーへのポインター。 バッファーは、ページングされたメモリに格納できます。

戻り値

DxgkDdiI2CReceiveDataFromDisplayは、成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合は、 Ntstatus.h で定義されているエラー コードのいずれかを返します。 次の一覧では、返される可能性のあるエラー コードの一部を示します。

注釈

VidPnTargetId によって識別されるビデオの現在のターゲットは、ディスプレイ アダプターのビデオ出力のいずれかに関連付けられています。 データは、そのビデオ出力に接続されているモニターの I2C デバイスから受信されます。

DxgkDdiI2CReceiveDataFromDisplay 関数は、I2C 開始条件の通知、I2C アドレスの送信、I2C デバイスからのデータの受信、受信確認の送信、停止条件の通知を行います。 I2C バスの詳細については、Philips Semiconductors によって公開されている I2C バス仕様に関するページを参照してください。 この仕様では、I2C 通信の開始、I2C データ行でのバイトの読み取りと書き込み、および I2C 通信の終了を行うプロトコルが定義されています。 (このリソースは、一部の言語では使用できない場合があります

国など)

DxgkDdiI2CReceiveDataFromDisplayは、アドレスが0x6Fされているが、異なるアドレスを持つ I2C デバイスからのデータの受信を拒否できる I2C デバイスからデータを受信するために必要です。

DxgkDdiI2CReceiveDataFromDisplay は、ディスプレイ ミニポート ドライバーまたはグラフィックス ハードウェアの別の部分が指定されたモニターの I2C バスを使用している場合にブロックできます。 また、ディスプレイ ミニポート ドライバーが I2C バスを使用して高帯域幅デジタル コンテンツ保護 (HDCP) データを送受信している場合は、ブロックすることもできます。

ディスプレイ アダプターが HDCP をサポートしている場合、デバイスに HDCP で使用される I2C アドレスがある場合、 DxgkDdiI2CReceiveDataFromDisplay は I2C デバイスからのデータの受信を拒否する必要があります。

DxgkDdiI2CReceiveDataFromDisplay は、ディスプレイ アダプター上の I2C デバイスからデータを受信してはなりません。 つまり、この関数は、ディスプレイ アダプターに接続されているモニター内の I2C デバイスからデータを受信できますが、ディスプレイ アダプター自体にある I2C デバイスからデータを受信することはできません。

DxgkDdiI2CReceiveDataFromDisplay をページング可能にする必要があります。

要件

こちらもご覧ください

DxgkDdiI2CTransmitDataToDisplay