IWDFIoRequest::GetOutputMemory 메서드(wudfddi.h)

[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한됩니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.]

GetOutputMemory 메서드는 I/O 요청에 대한 출력 버퍼를 나타내는 메모리 개체를 검색합니다.

구문

void GetOutputMemory(
  [out] IWDFMemory **ppWdfMemory
);

매개 변수

[out] ppWdfMemory

메모리 개체에 대한 참조 계산 IWDFMemory 인터페이스에 대한 포인터를 수신하는 변수에 대한 포인터입니다. NULL 반환은 유효합니다. 이 경우 출력 메모리가 I/O 요청과 연결되지 않습니다.

반환 값

없음

설명

버퍼링된 I/O 액세스 메서드를 사용하는 드라이버는 GetOutputMemory를 호출하여 I/O 요청의 출력 버퍼를 가져올 수 있습니다.

드라이버가 I/O 요청을 완료하기 전에 드라이버는 메모리 개체에 대한 IWDFMemory::Release 메서드를 호출해야 합니다. 요청이 완료되면 기본 메모리 개체가 해제됩니다.

I/O 요청과 연결된 출력 버퍼에는 드라이버가 요청의 보낸 사용자에게 제공하는 정보(예: 디스크의 데이터)가 포함됩니다. 드라이버는 GetOutputMemory 를 호출하여 읽기 요청 또는 디바이스 I/O 제어 요청에 대한 출력 버퍼를 가져올 수 있지만 쓰기 요청은 가져올 수 없습니다(쓰기 요청은 출력 데이터를 제공하지 않기 때문). 출력 버퍼에 액세스하려면 드라이버가 IWDFMemory::GetDataBuffer 메서드를 호출해야 합니다.

UMDF는 I/O 요청을 수신할 때 I/O 요청을 드라이버의 I/O 큐에 추가하기 전에 I/O 요청의 메모리 개체를 만듭니다. UMDF가 메모리 개체에 대한 메모리를 할당할 수 없는 경우 오류 반환 상태 I/O 요청을 완료하고 드라이버에 I/O 요청을 전달하지 않습니다.

I/O 요청의 데이터 버퍼에 액세스하는 방법에 대한 자세한 내용은 UMDF-Based 드라이버에서 데이터 버퍼 액세스를 참조하세요.

예제

GetOutputMemory 메서드를 사용하는 방법에 대한 코드 예제는 IWDFIoQueue::RetrieveNextRequest를 참조하세요.

요구 사항

요구 사항	값
지원 종료	UMDF 2.0 이상에서는 사용할 수 없습니다.
대상 플랫폼	데스크톱
최소 UMDF 버전	1.5
머리글	wudfddi.h(Wudfddi.h 포함)
DLL	WUDFx.dll

추가 정보

IWDFIoQueue::RetrieveNextRequest

IWDFIoRequest

IWDFMemory

IWDFMemory::GetDataBuffer