WdfMemoryCopyFromBuffer 関数 (wdfmemory.h)

[KMDF と UMDF に適用]

WdfMemoryCopyFromBuffer メソッドは、指定したソース バッファーの内容を、指定したメモリ オブジェクトのバッファーにコピーします。

構文

NTSTATUS WdfMemoryCopyFromBuffer(
  [in] WDFMEMORY DestinationMemory,
  [in] size_t    DestinationOffset,
  [in] PVOID     Buffer,
  [in] size_t    NumBytesToCopyFrom
);

パラメーター

[in] DestinationMemory

宛先バッファーを表すフレームワーク メモリ オブジェクトへのハンドル。

[in] DestinationOffset

宛先バッファーの先頭からのオフセット (バイト単位)。 コピー操作は、コピー先バッファー内の指定したオフセットから開始されます。

[in] Buffer

ソース バッファーへのポインター。

[in] NumBytesToCopyFrom

ソース バッファーからコピー先バッファーにコピーするバイト数。 この値は、ソース バッファーのサイズより大きくすることはできません。

戻り値

操作が成功した場合、WdfMemoryCopyFromBuffer はSTATUS_SUCCESSを返します。 それ以外の場合、このメソッドは次のいずれかの値を返す可能性があります。

このメソッドは、他の NTSTATUS 値を返す場合もあります。

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

注釈

このフレームワークでは、 NumBytesToCopyFrom パラメーターで指定されたデータ量を受け取るのに十分な大きさのバッファーがコピー先バッファーにあることを確認します。

フレームワーク メモリ オブジェクトの詳細については、「 メモリ バッファーの使用」を参照してください。

ソースまたは宛先バッファーがページング可能なメモリ プールから割り当てられた場合は、IRQL <= APC_LEVELで WdfMemoryCopyFromBuffer メソッドを呼び出す必要があります。 それ以外の場合は、任意の IRQL で メソッドを呼び出すことができます。

例

次のコード例では、I/O 要求の出力バッファーを表すフレームワーク メモリ オブジェクトへのハンドルを取得し、別のバッファーの内容を I/O 要求の出力バッファーにコピーします。

WDFMEMORY  memoryBuffer;
NTSTATUS  status;

status = WdfRequestRetrieveOutputMemory(
                                        Request,
                                        &memoryBuffer
                                        );
if (!NT_SUCCESS(status)) {
    goto Error;
}
status = WdfMemoryCopyFromBuffer(
                                 memoryBuffer,
                                 0,
                                 deviceContext->Buffer,
                                 Length
                                 );
if (!NT_SUCCESS(status)) {
    goto Error;
}

要件

こちらもご覧ください

WdfMemoryCopyToBuffer

WdfRequestRetrieveOutputMemory