IWDFIoRequest::GetFileObject 메서드(wudfddi.h)
[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에는 새로운 기능이 추가되지 않으며 최신 버전의 Windows 10에서는 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF시작 .]을 참조하세요.
GetFileObject 메서드는 I/O 요청과 연결된 IWDFFile 인터페이스에 대한 포인터를 검색합니다.
통사론
void GetFileObject(
[out] IWDFFile **ppFileObject
);
매개 변수
[out] ppFileObject
파일 개체의 IWDFFile 인터페이스에 대한 포인터를 수신하는 버퍼에 대한 포인터입니다. NULL 반환하는 것은 유효합니다.
반환 값
없음
발언
드라이버가 getFileObject 호출하면 프레임워크는 인터페이스에 대한 참조 수를 증가합니다. 드라이버는 인터페이스 포인터를 완료할 때 참조를 해제해야 합니다. 이렇게 하려면 개체가 컨텍스트를 벗어날 때 자동으로 참조 수를 감소시키는 스마트 포인터를 사용하거나, 완료될 때 인터페이스에서 Release 호출합니다.
예제
다음 코드 예제는 WDK의 WpdMultiTransportDriver 샘플에서 가져옵니다. 이 예제에서는 IWDFFile 인터페이스에 대한 스마트 포인터를 선언하고 GetFileObject 호출한 다음 파일 개체에서 RetrieveContext 호출합니다.
CComPtr<IWDFFile> pFileObject;
...
// Get the Context map for this client
pRequest->GetFileObject(&pFileObject);
if (pFileObject != NULL)
{
hr = pFileObject->RetrieveContext((void**)&pClientContextMap);
CHECK_HR(hr, "Failed to get Contextmap from WDF File Object");
}
요구 사항
| 요구 | 값 |
|---|---|
| 지원 종료 | UMDF 2.0 이상에서는 사용할 수 없습니다. |
| 대상 플랫폼 | 바탕 화면 |
| 최소 UMDF 버전 | 1.5 |
| 헤더 | wudfddi.h(Wudfddi.h 포함) |
| DLL | WUDFx.dll |