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 |