このメモリ領域からバイトの範囲を読み取ります。
構文
HRESULT Read(
UINT64 address,
UINT32 numberOfBytes,
_Out_writes_bytes_to_(numberOfBytes, *numberOfBytesRead) BYTE * values,
UINT32 * numberOfBytesRead);
パラメーター
address [in]
読み取るアドレス。
numberOfBytes [in]
読み取るバイト数。
values [out]
データを受け取る少なくとも numberOfBytes バイトの呼び出し元が割り当てたバッファー。
numberOfBytesRead [out]
実際に読み取られたバイト数 ( numberOfBytes未満の場合があります)。 読み取る前に 0 に設定します。つまり、失敗のたびに 0 になります。
戻り値
成功した場合はS_OK、それ以外の場合はエラー コード。
解説
読み取りは、要求された内容の一部のみを転送しても成功する可能性があるため、呼び出し元は、バッファー全体がいっぱいであると想定するのではなく、 numberOfBytesRead を参照S_OK必要があります。 そのカウントを超えるバイトは、呼び出し元が渡した時点で残ります。 何も転送しない読み取りは、カウント 0 で成功する代わりに失敗します。そのため、常に少なくとも 1 バイトが有効であることを意味しますS_OK。