IMDSPObject::Read メソッド (mswmdm.h)

Read メソッドは、現在位置にあるオブジェクトからデータを読み取ります。この操作は、ストレージオブジェクトがファイルを表す場合にのみ有効です。

構文

HRESULT Read(
  [out]     BYTE     *pData,
  [in, out] DWORD    *pdwSize,
  [in, out] BYTE [8] abMac
);

[out] pData

オブジェクトから読み取られたデータを受信するバッファーへのポインター。このパラメーターは出力メッセージ認証コードに含まれており、 CSecureChannelServer::EncryptParam を使用して暗号化する必要があります。「解説」を参照してください。

[in, out] pdwSize

読み取るデータのバイト数を指定する DWORD へのポインター。戻り時に、このパラメーターには実際に読み取られたデータ量が含まれます。このパラメーターは、入力メッセージ認証コードに含まれている必要があります。

[in, out] abMac

このメソッドのパラメーターデータのメッセージ認証コードを含む 8 バイトの配列。 (WMDM_MAC_LENGTHは 8 と定義されています。

このメソッドは HRESULT を返します。 Windows Media デバイスマネージャーのすべてのインターフェイスメソッドは、次のいずれかのエラーコードクラスを返すことができます。

考えられるエラーコードの詳細な一覧については、「エラーコード」を参照してください。

暗号化に使用される MAC は、CSecureChannelServer::MACUpdate の呼び出しに pData と pdwSize の両方を含める必要があります。

このメソッドは省略可能です。詳細については、「必須インターフェイスとオプションインターフェイス」を参照してください。